kie-ai

name

kie-ai

description

Kie AI is an AI platform that provides APIs for generating images, video, music, and voice content, enabling developers and businesses to integrate multimodal generative capabilities into applications, creative workflows, and automated content production systems. Read and write Kie AI data through One: jobs, claudemessages, responses, musicgeneration, downloadurl, remainingcredits and more, 171 actions with real parameter documentation. Use whenever the user asks to look something up in Kie AI, create or update a record there, or build code against the Kie AI API.

Kie AI through One

Kie AI is an AI platform that provides APIs for generating images, video, music, and voice content, enabling developers and businesses to integrate multimodal generative capabilities into applications, creative workflows, and automated content production systems.

One exposes Kie AI through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform kie-ai if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Kie AI is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Kie AI account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Jobs

Action	Method	Path	Action id
Create a Bytedance Seedance 1.5 Pro Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MJxH-abg::KJCIgCAgQL2DYXUhZMIYIA
Create a Bytedance Seedance 2.0 Fast Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MJ7ya_Ng::yL_zZ5UGTtSY3bYgCFS3BA
Create a Bytedance Seedance 2.0 Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MJxw5YsA::HMsb6cGRRlSQq_xk2230bw
Create a Bytedance V1 Lite Image-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MJwRgDeg::vn0vKZcZTb-uOE72noJmow
Create a Bytedance V1 Pro Fast Image-to-Video Task	POST	/jobs/createTask	conn_mod_def::GK8MJ7r_C9A::Jm5ZTXdgS36IDIuQlMKIeA
Create a Bytedance V1 Pro Image-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MJ78WSZA::UMmJxeH_TS2vqVoirSTBUA
Create a Bytedance V1 Pro Text-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MJwaih8A::Zmr6mUARQBmbJuk61UBtVw
Create a Flux-2 Image-to-Image Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MKaHnulA::6eforagiTga-cDBc6HWM_Q
Create a Flux-2 Pro Image-to-Image Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MKaTvssA::uU95IjZNQjmth4FFd-ZlAw
Create a Flux-2 Pro Text-to-Image Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MKcPKWXA::_B2wWORIQLaTvuqgJdseag
Create a Flux-2 Text-to-Image Job	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MKZuRmLA::qnXnDE9SRmqcpimiVGM4IQ

53 more Jobs actions are available through search.

ClaudeMessages

Action	Method	Path	Action id
Create a Claude Haiku 4.5 Message	POST	/api/v1/claude/v1/messages	conn_mod_def::GK8MJ8KksBA::hEJXOn6_Qj2q-FxqcLqfRg
Create a Claude Opus 4.5 Message	POST	/api/v1/claude/v1/messages	conn_mod_def::GK8MJ7mHCgA::w-VE9qD6St2MPhMsc7q2ag
Create Claude Opus 4.6 Messages	POST	/api/v1/claude/v1/messages	conn_mod_def::GK8MKG90esg::hS9FDoGEQjOXpZFn8KsGDw
Create Claude Opus 4.7 Messages	POST	/claude/v1/messages	conn_mod_def::GK8MKHIZLSg::BNlCv7FbQRuEMEjQFrfSyA
Create Claude Sonnet 4.6 Messages	POST	/claude/v1/messages	conn_mod_def::GK8MKHWaZKg::b1-oLy4iRk64g0f81siNyg

Responses

Action	Method	Path	Action id
Create a Codex Response	POST	/api/v1/responses	conn_mod_def::GK8ML41D7tg::n5U9rSElRTSTn4eAOZci8g
Create a GPT-5-4 Response	POST	/codex/v1/responses	conn_mod_def::GK8MK4en-hg::2QA59GQ8RtaI2_YQRX_Ayw
Create a GPT-5.5 Response	POST	/codex/v1/responses	conn_mod_def::GK8ML5w5fgg::7Hl0KCNzRwOLvHGA2MKJ6g

MusicGeneration

Action	Method	Path	Action id
Add Instrumental to Music	POST	/api/v1/generate/add-instrumental	conn_mod_def::GK8MQf6jF0A::q9Mi_MNPTDWgj5-QEkHAdA
Generate Music	POST	/api/v1/generate	conn_mod_def::GK8MQs5AiRA::O-fuYgR5S5-qsvjwpnIcOQ

DownloadUrl

Action	Method	Path	Action id
Get Download URL for Generated Files	POST	/api/v1/common/download-url	conn_mod_def::GK8MJbH6cjg::O5uQkMnBQUO9WY3IAfs6RA

RemainingCredits

Action	Method	Path	Action id
Get Remaining Credits	GET	/api/v1/chat/credit	conn_mod_def::GK8MJbVKBrA::bYVcB6kRQEuhXQblbiAq5g

Gpt4oImageRecordInfo

Action	Method	Path	Action id
Get 4o Image Details	GET	/gpt4o-image/record-info	conn_mod_def::GK8MJb_8TrA::wOnfBqrbSFqY0vBGp2EMeQ

Gpt4oImageDownloadUrl

Action	Method	Path	Action id
Get a Direct Download URL for a 4o Image	POST	/api/v1/gpt4o-image/download-url	conn_mod_def::GK8MJcYn2fg::gtCn-3hOTpqJsYNepcbM1w

Gpt4oImage

Action	Method	Path	Action id
Generate 4o Image	POST	/api/v1/gpt4o-image/generate	conn_mod_def::GK8MJcdsHbA::Zv2LP0f6QA6UB8xuD31eUQ

FluxKontextImages

Action	Method	Path	Action id
Generate or Edit an Image with Flux Kontext	POST	/api/v1/flux/kontext/generate	conn_mod_def::GK8MJk6eXFg::j37ROuFkTFu0HtkQRlCUjA

FileStreamUpload

Action	Method	Path	Action id
Upload a File Stream	POST	/api/v1/file-stream-upload	conn_mod_def::GK8MJlCIYag::DEq8XeqxRa6X4Qs6CGtBqQ

Files

Action	Method	Path	Action id
Upload a Base64 File	POST	/api/v1/file-base64-upload	conn_mod_def::GK8MJl0Qmlg::2sEfoHGXQB2rXTA_dI5xOA

FileUrlUpload

Action	Method	Path	Action id
Upload a File from a Remote URL	POST	/api/v1/file-url-upload	conn_mod_def::GK8MJl_lr3A::kqNu2FzfSBWDcCjLb5YlIw

FluxKontextImageDetails

Action	Method	Path	Action id
Get Flux Kontext Image Details	GET	/api/v1/flux/kontext/record-info	conn_mod_def::GK8MJm7hOeA::3Y8RPj6cSTG0X9_PB_Hl4w

BytedanceV1LiteTextToVideoTasks

Action	Method	Path	Action id
Create a Bytedance V1 Lite Text-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MJxUNsUA::uEXdxefrR7GHrln42gROhA

Messages

Action	Method	Path	Action id
Create a Claude Sonnet 4.5 Message	POST	/claude/v1/messages	conn_mod_def::GK8MKHZ9Spg::7al8IXaYTNGJRc-cf0INmQ

Gemini25FlashChatCompletions

Action	Method	Path	Action id
Create a Gemini 2.5 Flash Chat Completion	POST	/api/v1/gemini-2.5-flash/v1/chat/completions	conn_mod_def::GK8MKbkmyvg::WWw4692lSJWiPSsDOlc0Qg

Gemini3ProChatCompletions

Action	Method	Path	Action id
Create a Gemini 3 Pro Chat Completion	POST	/api/v1/gemini-3-pro/v1/chat/completions	conn_mod_def::GK8MKl3GstA::8KAtd3WqS1qChx-X8EtPhQ

Gemini3FlashContent

Action	Method	Path	Action id
Stream Generate Content with Gemini 3 Flash	POST	/gemini/v1/models/gemini-3-flash-v1betamodels:streamGenerateContent	conn_mod_def::GK8MKl-aQiA::HFTDuZywRO6feZWJVBemrA

Gemini25ProChatCompletions

Action	Method	Path	Action id
Create a Gemini 2.5 Pro Chat Completion	POST	/api/v1/gemini-2.5-pro/v1/chat/completions	conn_mod_def::GK8MKmQr4-g::ggBM_BWoQhmUxvhBvMvRDA

Gemini31ProChatCompletions

Action	Method	Path	Action id
Create a Gemini 3.1 Pro Chat Completion	POST	/api/v1/gemini-3.1-pro/v1/chat/completions	conn_mod_def::GK8MKmYSHJA::yo1ol4m6TXueYHQm7sVyqg

Gemini3FlashChatCompletions

Action	Method	Path	Action id
Create a Gemini 3 Flash Chat Completion	POST	/api/v1/gemini-3-flash/v1/chat/completions	conn_mod_def::GK8MKmhdFjA::8JIqTTX1Qw2jY8a1E9EOww

GoogleImagen4FastImageGenerationTask

Action	Method	Path	Action id
Create a Google Imagen 4 Fast Image Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MKuv_9Fg::2I4xVGPgRtugyLAmAq0vNA

GoogleImagen4UltraGenerationTasks

Action	Method	Path	Action id
Create a Google Imagen 4 Ultra Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MKvJDdHA::Oe5SruKUSH-Gkl78slTxDw

MarketTasks

Action	Method	Path	Action id
Get Market Task Details	GET	/api/v1/jobs/recordInfo	conn_mod_def::GK8MKvN1HnA::4Gzk1PQqRqK3FBZ9gvy2OA

GenerationTasks

Action	Method	Path	Action id
Create a Google Nano Banana Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MKvoRr1A::gyg2VEsgQ7u2VRxxIUMC1w

GoogleImagen4GenerationTasks

Action	Method	Path	Action id
Create a Google Imagen 4 Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MKvt3B8g::qzbo6BxQSL6vBtRIY-WUVw

GoogleNanoBananaEditTasks

Action	Method	Path	Action id
Create a Google Nano Banana Edit Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MK5NoQzA::1RpHSEf_QSyt3gpySnLZ2w

ChatCompletions

Action	Method	Path	Action id
Create a GPT-5.2 Chat Completion	POST	/api/v1/gpt-5-2/v1/chat/completions	conn_mod_def::GK8MLv6dFqA::VOsDQi5kTWCDWDDVlzOLIg

GptImage15ImageToImageGenerationTasks

Action	Method	Path	Action id
Create a GPT Image 1.5 Image-to-Image Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8ML5wCeBg::i3nf0igURJ-EbLArI5lRKQ

GrokImagineVideoUpscaleTasks

Action	Method	Path	Action id
Create a Grok Imagine Video Upscale Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMDHwcUA::ZvcHZ9aAQi-o4BD4db6YYA

GrokImagineTextToImageJobs

Action	Method	Path	Action id
Create a Grok Imagine Text-to-Image Job	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMDbzGKA::WyjUFFKqT0G6YYPlIMd_Zg

GrokImagineTextToVideoTasks

Action	Method	Path	Action id
Create a Grok Imagine Text-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMNYogxA::Cz6Pinu4Td6x44rbvE9eSA

GrokImagineImageToVideoTasks

Action	Method	Path	Action id
Create a Grok Imagine Image-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMNeOpqg::35lj2cJ2Sa6_xjkknIfC_A

Hailuo23StandardImageToVideoTask

Action	Method	Path	Action id
Create a Hailuo 2.3 Standard Image-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMOWQWCg::kGBbdCu7TcmUrf-3svBQ-Q

HappyHorseReferenceToVideoTask

Action	Method	Path	Action id
Create a HappyHorse Reference-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMX-yz1g::1XNlHcS5S-aMiLuvqaAUVg

HappyHorseImageToVideoTasks

Action	Method	Path	Action id
Create a HappyHorse Image-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMYFs-qg::Haydlp11Q3mskN5dO7nL1w

HailuoStandardTextToVideoTask

Action	Method	Path	Action id
Create a Hailuo Standard Text-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMZBgcrA::NOxIoEUDSVuMHdUEy-3qzA

HappyHorseTextToVideoTask

Action	Method	Path	Action id
Create a HappyHorse Text-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMibvrRg::UWxrwZvESn6oBh92YBfh1A

IdeogramCharacterRemixTask

Action	Method	Path	Action id
Create an Ideogram Character Remix Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMicLnXA::rHqNxqZVTCGcxq6zfW_3vQ

IdeogramCharacterEditTask

Action	Method	Path	Action id
Create an Ideogram Character Edit Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMisjWDA::hGXnES9jSLOKAZ-5eW7h8Q

HappyHorseVideoEditTasks

Action	Method	Path	Action id
Create a HappyHorse Video Edit Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMi4bDJA::Jq5oHdZGSNy5WL9h8HU2-g

IdeogramV3EditTasks

Action	Method	Path	Action id
Create an Ideogram V3 Edit Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMtFir5g::h1uVMEFvQ8K_RhAFv1p9Uw

InfinitalkFromAudioGenerationTasks

Action	Method	Path	Action id
Create an Infinitalk From-Audio Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MMtyf6eg::XBSMBgmVRnykTtUnWKRd1w

Kling30VideoGenerationTask

Action	Method	Path	Action id
Create a Kling 3.0 Video Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MM8BNOPg::q4PAI6vSR5Of30q2Wod26g

KlingAiAvatarStandardJobs

Action	Method	Path	Action id
Create a Kling AI Avatar Standard Job	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MNFRZZkg::f8pqtA-7RtS__6ofLp09bw

KlingV21ProCopyPageTask

Action	Method	Path	Action id
Create a Kling V2.1 Pro Copy Page Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MNGD8VtA::S6ZxPRsKT5yZfhVfxpKXEw

QwenImageEditTasks

Action	Method	Path	Action id
Create a Qwen Image Edit Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MNRLt0jg::x23PPSNBQgKdr15qScf8Yg

KlingV21StandardGenerationTask

Action	Method	Path	Action id
Create a Kling V2.1 Standard Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MNSa_fZg::vZz5lp4JQym-V0Mz_USplg

RecraftRemoveBackgroundTask

Action	Method	Path	Action id
Create a Recraft Remove Background Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MNa2zxPg::7-RMmzILQsCt01qCDm_jvw

SeedreamTasks

Action	Method	Path	Action id
Create a Seedream 3.0 Text-to-Image Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MNcB6Kng::RR3JmK3yQ5ymUaxHK7V8Gg

RecraftCrispUpscaleTask

Action	Method	Path	Action id
Create a Recraft Crisp Upscale Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MNcuJ1Lg::cebtsbfWRpKuIRV1tBDY0A

Seedream40TextToImageGenerationTasks

Action	Method	Path	Action id
Create a Seedream4.0 Text-to-Image Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MNq1IMMA::_GycVCSkTfOLPfx0-MI6Tg

Sora2CharacterAnimationTasks

Action	Method	Path	Action id
Create a Sora2 Character Animation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MOm3EPSg::U0oBX3XyS8eEND_VOnOn1A

Sora2ImageToVideoTasks

Action	Method	Path	Action id
Create a Sora2 Image-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MOn9xVvA::28PMgoaIQBmslsWaGBbIQg

TopazImageUpscaleTasks

Action	Method	Path	Action id
Create a Topaz Image Upscale Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MOyWBQbg::_987pBboRzOnMKagkffCJQ

Sora2WatermarkRemoverTasks

Action	Method	Path	Action id
Create a Sora2 Watermark Remover Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MOzfyxMA::i6eqC_iATI2tsaReZNgUAw

WanAnimateMoveGenerationTask

Action	Method	Path	Action id
Create a Wan Animate Move Generation Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MO717akg::Vnz70VvnRQiAIsFU_G0HYA

Wan26FlashImageToVideoTasks

Action	Method	Path	Action id
Create a Wan 2.6 Flash Image-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MO8MjUlg::jrX47dgyQEmMoyV5yyUcSw

TopazVideoUpscaleTasks

Action	Method	Path	Action id
Create a Topaz Video Upscale Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MO8S3KSg::qq30Ec2TQGGCxGR7EaAYpg

Wan25ImageToVideoTasks

Action	Method	Path	Action id
Create a Wan 2.5 Image-to-Video Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MPJJJnEA::A3hc9YtgSK2QhxkBz8lkiA

WanAnimateReplaceTasks

Action	Method	Path	Action id
Create a Wan Animate Replace Task	POST	/api/v1/jobs/createTask	conn_mod_def::GK8MPJOy-_g::eASTCrhbSR2h9urLAXsYDA

This lists 80 of 171 actions. For anything not here, call search_one_platform_actions with platform kie-ai. The full catalog is at https://www.withone.ai/knowledge/kie-ai.

When a call fails

The error comes from Kie AI, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/kie-ai

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.