{
  "General Info": {
    "name": "General Info",
    "slug": "apiReference_commonInfo",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 7747,
    "fields": [
      "duration",
      "mode",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Parameters",
        "snippet": "ion\tUnauthorized access to requested resource, such as API/model\tVerifying account permissions\n400\t1200\tInvalid request parameters\tInvalid request parameters\tCheck whether the request parameters are correct\n400\t1201\tInvalid request parameters\tInvalid parameters, such as incorrect key or illegal value\tRefer to the specific information in the message field of the returned body and modify the request parameters\n404\t1202\tInvalid request parameters\tThe requested method is invalid\tReview the API documentation and use the correct request method\n404\t1203\tInvalid request parameters\tThe requested resource does not exist, such as the model\tRefer to the specific information in the message field of the returned body and modify the request parameters\n400\t1300\tTrigger strategy\tTrigger strategy of the platform\tCheck if any platform policies have been triggered\n400\t1301\tTrigger strategy\tTrigger the content security policy of the platform\tCheck the input content, modify it, and resend the request\n429\t1302\tTrigger strategy\t"
      },
      {
        "pattern": "QPS",
        "snippet": " frequency, try again later, or contact customer service to increase the limit\n429\t1303\tTrigger strategy\tConcurrency or QPS exceeds the prepaid resource package limit\tReduce the request frequency, try again later, or contact customer service to increase the limit\n429\t1304\tTrigger strategy\tTrigger the platform’s IP whitelisting policy\tContact customer service\n500\t5000\tInternal error\tServer internal error\tTry again later, or contact customer service\n503\t5001\tInternal error\tServer temporarily unavailable, usually due to maintenance\tTry again later, or contact customer service\n504\t5002\tInternal error\tServer internal timeout, usually due to a backlog\tTry again later, or contact customer service\nPrevious chapter：Changelog\nNext chapter：Rate Limits\nAPI Domain\nAPI Authentication\nError Code\nThe Kling 3.0 Series Models API is Now Fully Available\n– All in One, One for All！\n\nModels Available in This Release\n\nKling 3.0 Motion Control, Kling Video 3.0, Kling Video 3.0 Omni, Kling Image 3.0, Kling Image 3.0 Omni\n\nRefer t"
      }
    ],
    "notes": [
      "concurrency rule present"
    ]
  },
  "Rate Limits": {
    "name": "Rate Limits",
    "slug": "apiReference_rateLimits",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 5452,
    "fields": [
      "duration",
      "mode",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Concurrency Rules",
        "snippet": "ng Info\nPrepaid Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nConcurrency Rules\nWhat is Kling API concurrency?\n\nKling API concurrency refers to the maximum number of generation tasks that an account can process in parallel at any given time. This capability is determined by the resource package. A higher concurrency level allows you to submit more API generation requests simultaneously (each call to the task creation interface initiates a new generation task).\n\n💡\n\nNotes\n\nThis only applies to the task creation interface; query interfaces do not consume concurrency.\nThis limitation concerns the number of concurrent tasks and is unrelated to Queries Per Second(QPS)— the system imposes no QPS limit.\nCore Rules\nDimension\tRule Description\nApplication Scope\tApplied at the account level. Calculated independently per resource pack type (video/image/virtual try-on). All API keys under the same account share the same concurrency quota.\nOccupancy Logic\tA task "
      },
      {
        "pattern": "QPS",
        "snippet": "not consume concurrency.\nThis limitation concerns the number of concurrent tasks and is unrelated to Queries Per Second(QPS)— the system imposes no QPS limit.\nCore Rules\nDimension\tRule Description\nApplication Scope\tApplied at the account level. Calculated independently per resource pack type (video/image/virtual try-on). All API keys under the same account share the same concurrency quota.\nOccupancy Logic\tA task occupies concurrency from entering submitted status until completion (including failures). Released immediately after task ends.\nQuota Calculation\tDetermined by the highest concurrency value among all active resource packages of the same type. Example: If a 5-concurrency + 10-concurrency video package are both active → video concurrency capacity = 10\n\nSpecial Notes\n\nVideo / Virtual Try-on tasks: Each task occupies 1 concurrency.\nImage generation tasks: Concurrency used = the n value in the API request parameter. (Example: n = 9 → occupies 9 concurrency)\nOver-limit Error Mechanism\n\nWhen the number "
      }
    ],
    "notes": [
      "concurrency rule present"
    ]
  },
  "Callback Schema": {
    "name": "Callback Schema",
    "slug": "apiReference_callbackProtocol",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 5596,
    "fields": [
      "prompt",
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": " for the Async task（image generation / video generation / virtual try-on），if you actively set the callback_url when you Create Task, the server will actively notify you when the task status changes, and the protocol is as follows:\n\nJSON\nCopy\nCollapse\n{\n  \"task_id\": \"string\",               // Task ID, generated by the system\n  \"task_status\": \"string\",           // Task status, Enum values: submitted, processing, succeed, failed\n  \"task_status_msg\": \"string\",       // Task status information, displaying the failure reason when the task fails (such as triggering the content risk control of the platform, etc.)\n  \"created_at\": 1722769557708,       // Task creation time, Unix timestamp, unit ms\n  \"updated_at\": 1722769557708,       // Task update time, Unix timestamp, unit ms\n  \"final_unit_deduction\": \"string\",   // The deduction units of task\n  \"task_info\": {                     // Task creation parameters. Detailed information provided by the user during task creation.\n    \"parent_video\": {\n      \"id\": \"string"
      },
      {
        "pattern": "Parameters",
        "snippet": "final_unit_deduction\": \"string\",   // The deduction units of task\n  \"task_info\": {                     // Task creation parameters. Detailed information provided by the user during task creation.\n    \"parent_video\": {\n      \"id\": \"string\",                // Generated video ID; globally unique\n      \"url\": \"string\",               // URL for generating images (To ensure information security, generated images/videos will be cleared after 30 days. Please make sure to save them promptly.)\n      \"duration\": \"string\"           // Total duration of the video before continuation, in s\n    },\n    \"external_task_id\": \"string\"     // Customer-defined task ID\n  },\n  \"task_result\": {\n    \"images\": [                      // The result of image-related tasks\n      {\n        \"index\": int,                // Image Number\n        \"url\": \"string\"              // URL for generating images, such as: https://h1.inkwai.com/bs2/upload-ylab-stunt/xxx.png (To ensure information security, generated images/videos will be cleared after"
      },
      {
        "pattern": "callback_url",
        "snippet": "\nCallback Protocol\n\nAs for the Async task（image generation / video generation / virtual try-on），if you actively set the callback_url when you Create Task, the server will actively notify you when the task status changes, and the protocol is as follows:\n\nJSON\nCopy\nCollapse\n{\n  \"task_id\": \"string\",               // Task ID, generated by the system\n  \"task_status\": \"string\",           // Task status, Enum values: submitted, processing, succeed, failed\n  \"task_status_msg\": \"string\",       // Task status information, displaying the failure reason when the task fails (such as triggering the content risk control of the platform, etc.)\n  \"created_at\": 1722769557708,       // Task creation time, Unix timestamp, unit ms\n  \"updated_at\": 1722769557708,       // Task update time, Unix timestamp, unit ms\n  \"final_unit_deduction\": \"string\",   // The deduction units of task\n  \"task_info\": {                     // Task creation parameters. Detailed information provided by the user during task creation.\n    \"parent_video\":"
      },
      {
        "pattern": "external_task_id",
        "snippet": "em promptly.)\n      \"duration\": \"string\"           // Total duration of the video before continuation, in s\n    },\n    \"external_task_id\": \"string\"     // Customer-defined task ID\n  },\n  \"task_result\": {\n    \"images\": [                      // The result of image-related tasks\n      {\n        \"index\": int,                // Image Number\n        \"url\": \"string\"              // URL for generating images, such as: https://h1.inkwai.com/bs2/upload-ylab-stunt/xxx.png (To ensure information security, generated images/videos will be cleared after 30 days. Please make sure to save them promptly.)\n      }\n    ],\n    \"videos\": [                      // The result of video-related tasks\n      {\n        \"id\": \"string\",              // Generated video ID; globally unique\n        \"url\": \"string\",             // URL for generating videos (To ensure information security, generated images/videos will be cleared after 30 days. Please make sure to save them promptly.)\n        \"duration\": \"string\"         // Total video dura"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Models": {
    "name": "Models",
    "slug": "apiReference_model__imageModels",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 6668,
    "fields": [
      "duration",
      "mode",
      "text"
    ],
    "snippets": [],
    "notes": []
  },
  "Video Omni": {
    "name": "Video Omni",
    "slug": "apiReference_model__OmniVideo",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 26974,
    "method": "POST",
    "path": "/v1/videos/omni-video",
    "fields": [
      "model_name",
      "prompt",
      "duration",
      "mode",
      "aspect_ratio",
      "callback_url",
      "external_task_id",
      "image_list",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "paid Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nOmni-Video\nCreate Task\nPOST\n/v1/videos/omni-video\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/omni-video \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"model_name\": \"kling-video-o1\",\n  \"prompt\": \"Make the person in <<<image_1>>> wave to the camera\",\n  \"image_list\": [\n    {\n      \"image_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\"\n    }\n  ],\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"aspect_ratio\": \"16:9\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used for tracking requests and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, "
      },
      {
        "pattern": "cURL",
        "snippet": "olicy of API Service\nTerms of API Service\nAPI Service Level Agreement\nOmni-Video\nCreate Task\nPOST\n/v1/videos/omni-video\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/omni-video \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"model_name\": \"kling-video-o1\",\n  \"prompt\": \"Make the person in <<<image_1>>> wave to the camera\",\n  \"image_list\": [\n    {\n      \"image_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\"\n    }\n  ],\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"aspect_ratio\": \"16:9\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used for tracking requests and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\""
      },
      {
        "pattern": "Parameters",
        "snippet": "bleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\n\nThe Omni model can achieve various capabilities through Prompt with elements, images, videos, and other content.\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nmodel_name\nstring\nOptional\nDefault to kling-video-o1\n\nModel Name\n\nEnum values：\nkling-video-o1\nkling-v3-omni\nmulti_shot\nboolean\nOptional\nDefault to false\n\nWhether to generate multi-shot video.\n\nWhen true: the prompt parameter is invalid, and it does not"
      },
      {
        "pattern": "callback_url",
        "snippet": "n/cdn-kcdn112452/kling-qa-test/multi-1.png\"\n    }\n  ],\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"aspect_ratio\": \"16:9\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used for tracking requests and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\n\nThe Omni model can achieve various capabilities through Prompt with elements, images, videos, and other content.\n\nRequest Header\nContent-Type\nstring"
      },
      {
        "pattern": "external_task_id",
        "snippet": "-qa-test/multi-1.png\"\n    }\n  ],\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"aspect_ratio\": \"16:9\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used for tracking requests and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\n\nThe Omni model can achieve various capabilities through Prompt with elements, images, videos, and other content.\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to a"
      },
      {
        "pattern": "model_name",
        "snippet": "/omni-video \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"model_name\": \"kling-video-o1\",\n  \"prompt\": \"Make the person in <<<image_1>>> wave to the camera\",\n  \"image_list\": [\n    {\n      \"image_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\"\n    }\n  ],\n  \"duration\": \"5\",\n  \"mode\": \"pro\",\n  \"aspect_ratio\": \"16:9\",\n  \"callback_url\": \"\",\n  \"external_task_id\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used for tracking requests and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported",
      "reference-video style usage visible"
    ]
  },
  "Text to Video": {
    "name": "Text to Video",
    "slug": "apiReference_model__textToVideo",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 18301,
    "method": "POST",
    "path": "/v1/videos/text2video",
    "fields": [
      "model_name",
      "prompt",
      "negative_prompt",
      "duration",
      "mode",
      "aspect_ratio",
      "callback_url",
      "external_task_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "d Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nText to Video\nCreate Task\nPOST\n/v1/videos/text2video\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/text2video \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v2-6\",\n    \"prompt\": \"A cute little rabbit wearing glasses, sitting at a table, reading a newspaper, with a cup of cappuccino on the table\",\n    \"negative_prompt\": \"\",\n    \"duration\": \"5\",\n    \"mode\": \"pro\",\n    \"sound\": \"on\",\n    \"aspect_ratio\": \"1:1\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation "
      },
      {
        "pattern": "cURL",
        "snippet": "cy of API Service\nTerms of API Service\nAPI Service Level Agreement\nText to Video\nCreate Task\nPOST\n/v1/videos/text2video\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/text2video \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v2-6\",\n    \"prompt\": \"A cute little rabbit wearing glasses, sitting at a table, reading a newspaper, with a cup of cappuccino on the table\",\n    \"negative_prompt\": \"\",\n    \"duration\": \"5\",\n    \"mode\": \"pro\",\n    \"sound\": \"on\",\n    \"aspect_ratio\": \"1:1\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"s"
      },
      {
        "pattern": "Parameters",
        "snippet": "the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\n💡\n\nPlease note that in order to maintain naming consistency, the original model field has been changed to model_name, so in the future, please use this field to specify the version of the model that needs to be called.\nAt the same time, we keep the behavior forward-compatible. If you continue to use the original model field, it will not have any impact on the interface call, there will not be any exception, which is equivalent to the default behavior when model_name is empty (i.e., call the V1 model).\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault"
      },
      {
        "pattern": "callback_url",
        "snippet": ",\n    \"negative_prompt\": \"\",\n    \"duration\": \"5\",\n    \"mode\": \"pro\",\n    \"sound\": \"on\",\n    \"aspect_ratio\": \"1:1\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\n💡\n\nPlease note that in order to maintain naming consistency, the original model field has been changed to model_name, so in the future, please use this field to specify the version of the mod"
      },
      {
        "pattern": "external_task_id",
        "snippet": " \"\",\n    \"duration\": \"5\",\n    \"mode\": \"pro\",\n    \"sound\": \"on\",\n    \"aspect_ratio\": \"1:1\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\n💡\n\nPlease note that in order to maintain naming consistency, the original model field has been changed to model_name, so in the future, please use this field to specify the version of the model that needs to be call"
      },
      {
        "pattern": "model_name",
        "snippet": "ext2video \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v2-6\",\n    \"prompt\": \"A cute little rabbit wearing glasses, sitting at a table, reading a newspaper, with a cup of cappuccino on the table\",\n    \"negative_prompt\": \"\",\n    \"duration\": \"5\",\n    \"mode\": \"pro\",\n    \"sound\": \"on\",\n    \"aspect_ratio\": \"1:1\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, uni"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Image to Video": {
    "name": "Image to Video",
    "slug": "apiReference_model__imageToVideo",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 24721,
    "method": "POST",
    "path": "/v1/videos/image2video",
    "fields": [
      "model_name",
      "prompt",
      "negative_prompt",
      "duration",
      "mode",
      "aspect_ratio",
      "callback_url",
      "external_task_id",
      "text",
      "voice_id"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": " Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nImage to Video\nCreate Task\nPOST\n/v1/videos/image2video\ncURL\nCopy\nCollapse\ncurl --location --request POST 'https://api-singapore.klingai.com/v1/videos/image2video' \\\n--header 'Authorization: Bearer <token>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"model_name\": \"kling-v2-6\",\n    \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\",\n    \"image_tail\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n    \"prompt\": \"Camera zooms out, the girl smiles\",\n    \"negative_prompt\": \"\",\n    \"duration\": \"5\",\n    \"mode\": \"pro\",\n    \"sound\": \"off\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"st"
      },
      {
        "pattern": "cURL",
        "snippet": " of API Service\nTerms of API Service\nAPI Service Level Agreement\nImage to Video\nCreate Task\nPOST\n/v1/videos/image2video\ncURL\nCopy\nCollapse\ncurl --location --request POST 'https://api-singapore.klingai.com/v1/videos/image2video' \\\n--header 'Authorization: Bearer <token>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"model_name\": \"kling-v2-6\",\n    \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\",\n    \"image_tail\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n    \"prompt\": \"Camera zooms out, the girl smiles\",\n    \"negative_prompt\": \"\",\n    \"duration\": \"5\",\n    \"mode\": \"pro\",\n    \"sound\": \"off\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the syst"
      },
      {
        "pattern": "Parameters",
        "snippet": "the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\n💡\n\nPlease note that in order to maintain naming consistency, the original model field has been changed to model_name. Please use this field to specify the model version in the future.\nWe maintain backward compatibility. If you continue using the original model field, it will not affect API calls and will be equivalent to the default behavior when model_name is empty (i.e., calling the V1 model).\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer"
      },
      {
        "pattern": "callback_url",
        "snippet": "ooms out, the girl smiles\",\n    \"negative_prompt\": \"\",\n    \"duration\": \"5\",\n    \"mode\": \"pro\",\n    \"sound\": \"off\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\n💡\n\nPlease note that in order to maintain naming consistency, the original model field has been changed to model_name. Please use this field to specify the model version in the future.\nWe mainta"
      },
      {
        "pattern": "external_task_id",
        "snippet": "s\",\n    \"negative_prompt\": \"\",\n    \"duration\": \"5\",\n    \"mode\": \"pro\",\n    \"sound\": \"off\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\n💡\n\nPlease note that in order to maintain naming consistency, the original model field has been changed to model_name. Please use this field to specify the model version in the future.\nWe maintain backward compatibilit"
      },
      {
        "pattern": "model_name",
        "snippet": "mage2video' \\\n--header 'Authorization: Bearer <token>' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"model_name\": \"kling-v2-6\",\n    \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\",\n    \"image_tail\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n    \"prompt\": \"Camera zooms out, the girl smiles\",\n    \"negative_prompt\": \"\",\n    \"duration\": \"5\",\n    \"mode\": \"pro\",\n    \"sound\": \"off\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Reference to Video": {
    "name": "Reference to Video",
    "slug": "apiReference_model__multiImageToVideo",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 11816,
    "method": "POST",
    "path": "/v1/videos/multi-image2video",
    "fields": [
      "model_name",
      "prompt",
      "negative_prompt",
      "duration",
      "mode",
      "aspect_ratio",
      "callback_url",
      "external_task_id",
      "image_list",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "rce Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nMulti-Image to Video\nCreate Task\nPOST\n/v1/videos/multi-image2video\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/multi-image2video \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v1-6\",\n    \"image_list\": [\n      { \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png\" },\n      { \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog_cloth.png\" }\n    ],\n    \"prompt\": \"A white Bichon Frise wearing a red Northeast-style floral cotton jacket, licking its paw\",\n    \"negative_prompt\": \"\",\n    \"mode\": \"pro\",\n    \"duration\": \"5\",\n    \"aspect_ratio\": \"16:9\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error m"
      },
      {
        "pattern": "cURL",
        "snippet": "ice\nTerms of API Service\nAPI Service Level Agreement\nMulti-Image to Video\nCreate Task\nPOST\n/v1/videos/multi-image2video\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/multi-image2video \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v1-6\",\n    \"image_list\": [\n      { \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png\" },\n      { \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog_cloth.png\" }\n    ],\n    \"prompt\": \"A white Bichon Frise wearing a red Northeast-style floral cotton jacket, licking its paw\",\n    \"negative_prompt\": \"\",\n    \"mode\": \"pro\",\n    \"duration\": \"5\",\n    \"aspect_ratio\": \"16:9\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID"
      },
      {
        "pattern": "Parameters",
        "snippet": "ssage, displays failure reason when task fails (such as content moderation triggers)\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_result\": {\n      \"videos\": [\n        {\n          \"id\": \"string\", // Generated video ID; globally unique\n          \"url\": \"string\", // URL for generating videos (Please note that for security purposes, generated images/videos will be deleted after 30 days. Please save them promptly.)\n          \"watermark_url\": \"string\", // Watermarked video download URL, anti-hotlinking format\n          \"duration\": \"string\" //Total video duration, unit: s (seconds)\n        }\n      ]\n    },\n    \"watermark_info\": {\n      \"enabled\": boolean\n    },\n    \"final_unit_deduction\": \"string\", // Final unit deduction for the task\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequire"
      },
      {
        "pattern": "callback_url",
        "snippet": ", licking its paw\",\n    \"negative_prompt\": \"\",\n    \"mode\": \"pro\",\n    \"duration\": \"5\",\n    \"aspect_ratio\": \"16:9\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\n\nGenerate video from multiple reference images (elements).\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nmodel_"
      },
      {
        "pattern": "external_task_id",
        "snippet": "\"negative_prompt\": \"\",\n    \"mode\": \"pro\",\n    \"duration\": \"5\",\n    \"aspect_ratio\": \"16:9\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\n\nGenerate video from multiple reference images (elements).\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nmodel_name\nstring\nOptional\nDef"
      },
      {
        "pattern": "model_name",
        "snippet": "age2video \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v1-6\",\n    \"image_list\": [\n      { \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png\" },\n      { \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog_cloth.png\" }\n    ],\n    \"prompt\": \"A white Bichon Frise wearing a red Northeast-style floral cotton jacket, licking its paw\",\n    \"negative_prompt\": \"\",\n    \"mode\": \"pro\",\n    \"duration\": \"5\",\n    \"aspect_ratio\": \"16:9\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, pro"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Motion Control": {
    "name": "Motion Control",
    "slug": "apiReference_model__motionControl",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 14382,
    "method": "POST",
    "path": "/v1/videos/motion-control",
    "fields": [
      "model_name",
      "prompt",
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": " Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nMotion Control\nCreate Task\nPOST\n/v1/videos/motion-control\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/motion-control \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json; charset=utf-8' \\\n  --data-raw '{\n    \"model_name\": \"kling-v2-6\",\n    \"image_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png\",\n    \"prompt\": \"The girl is wearing a loose gray T-shirt and denim shorts\",\n    \"video_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4\",\n    \"keep_original_sound\": \"yes\",\n    \"character_orientation\": \"image\",\n    \"mode\": \"pro\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"xxx\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Reque"
      },
      {
        "pattern": "cURL",
        "snippet": " API Service\nTerms of API Service\nAPI Service Level Agreement\nMotion Control\nCreate Task\nPOST\n/v1/videos/motion-control\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/motion-control \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json; charset=utf-8' \\\n  --data-raw '{\n    \"model_name\": \"kling-v2-6\",\n    \"image_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png\",\n    \"prompt\": \"The girl is wearing a loose gray T-shirt and denim shorts\",\n    \"video_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4\",\n    \"keep_original_sound\": \"yes\",\n    \"character_orientation\": \"image\",\n    \"mode\": \"pro\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"xxx\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to tra"
      },
      {
        "pattern": "Parameters",
        "snippet": "ot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nmodel_name\nstring\nOptional\nDefault to kling-v2-6\n\nModel Name\n\nEnum values：\nkling-v2-6\nkling-v3\nprompt\nstring\nOptional\n\nText prompt, can include positive and negative descriptions\n\nCan add elements to the scene, achieve camera movement effects, etc. See Kling \"Motion Control\" User Guide\nCannot exceed 2500 characters\nimage_url\nstring\nRequired\n\nReference image. Ch"
      },
      {
        "pattern": "callback_url",
        "snippet": "ing-qa-test/dance.mp4\",\n    \"keep_original_sound\": \"yes\",\n    \"character_orientation\": \"image\",\n    \"mode\": \"pro\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"xxx\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthenticatio"
      },
      {
        "pattern": "external_task_id",
        "snippet": "    \"keep_original_sound\": \"yes\",\n    \"character_orientation\": \"image\",\n    \"mode\": \"pro\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"xxx\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to "
      },
      {
        "pattern": "model_name",
        "snippet": "der 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json; charset=utf-8' \\\n  --data-raw '{\n    \"model_name\": \"kling-v2-6\",\n    \"image_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png\",\n    \"prompt\": \"The girl is wearing a loose gray T-shirt and denim shorts\",\n    \"video_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4\",\n    \"keep_original_sound\": \"yes\",\n    \"character_orientation\": \"image\",\n    \"mode\": \"pro\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"xxx\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"task_s"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported",
      "reference-video style usage visible"
    ]
  },
  "Multi-elements to video": {
    "name": "Multi-elements to video",
    "slug": "apiReference_model__multiElements",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 24900,
    "method": "POST",
    "path": "/v1/videos/multi-elements/init-selection",
    "fields": [
      "model_name",
      "prompt",
      "negative_prompt",
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "video_id",
      "image_list",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "g\nRequired\n\nSession ID, generated during the video initialization task and remains unchanged during editing operations\n\nCreate Task\nPOST\n/v1/videos/multi-elements\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/multi-elements \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v1-6\",\n    \"session_id\": \"847570360458960960\",\n    \"edit_mode\": \"removal\",\n    \"image_list\": [],\n    \"prompt\": \"Delete the chick from <<<video_1>>>\",\n    \"negative_prompt\": \"\",\n    \"mode\": \"std\",\n    \"duration\": \"5\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used for tracking requests and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"st"
      },
      {
        "pattern": "cURL",
        "snippet": "e\nAPI Service Level Agreement\nMulti-Elements\nInitialize Video for Editing\nPOST\n/v1/videos/multi-elements/init-selection\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/multi-elements/init-selection \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"video_id\": \"\",\n    \"video_url\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/animals-output-5s.mp4\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used for tracking requests and troubleshooting\n  \"data\": {\n    \"status\": 0, // Rejection code, non-zero indicates recognition failure\n    \"session_id\": \"id\", // Session ID, generated during video initialization task, remains unchanged during editing operations, valid for 24 hours\n    \"final_unit_deduction\": \"string\", // The deduction uni"
      },
      {
        "pattern": "Parameters",
        "snippet": "splays failure reason when task fails (e.g., triggered platform content moderation)\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // User-defined task ID\n    },\n    \"task_result\": {\n      \"videos\": [\n        {\n          \"id\": \"string\", // Generated video ID, globally unique\n          \"session_id\": \"id\", // Session ID, generated during video initialization task, remains unchanged during editing operations, valid for 24 hours\n          \"url\": \"string\", // URL of generated video (Note: For security purposes, generated images/videos will be deleted after 30 days, please save them promptly)\n          \"watermark_url\": \"string\", // Watermarked video download URL, anti-hotlinking format\n          \"duration\": \"string\" // Total video duration, unit: s\n        }\n      ]\n    },\n    \"watermark_info\": {\n      \"enabled\": boolean\n    },\n    \"final_unit_deduction\": \"string\", // Final unit deduction for the task\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit"
      },
      {
        "pattern": "callback_url",
        "snippet": "prompt\": \"Delete the chick from <<<video_1>>>\",\n    \"negative_prompt\": \"\",\n    \"mode\": \"std\",\n    \"duration\": \"5\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used for tracking requests and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\": {\n      \"external_task_id\": \"string\" // User-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authenticat"
      },
      {
        "pattern": "external_task_id",
        "snippet": "ck from <<<video_1>>>\",\n    \"negative_prompt\": \"\",\n    \"mode\": \"std\",\n    \"duration\": \"5\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used for tracking requests and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\": {\n      \"external_task_id\": \"string\" // User-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nmodel_"
      },
      {
        "pattern": "model_name",
        "snippet": "-elements \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v1-6\",\n    \"session_id\": \"847570360458960960\",\n    \"edit_mode\": \"removal\",\n    \"image_list\": [],\n    \"prompt\": \"Delete the chick from <<<video_1>>>\",\n    \"negative_prompt\": \"\",\n    \"mode\": \"std\",\n    \"duration\": \"5\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used for tracking requests and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\": {\n      \"external_task_id\": \"string\" // User-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 17"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Extend Video": {
    "name": "Extend Video",
    "slug": "apiReference_model__videoExtension",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 11576,
    "method": "POST",
    "path": "/v1/videos/video-extend",
    "fields": [
      "prompt",
      "negative_prompt",
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "video_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nVideo Extension\nCreate Task\nPOST\n/v1/videos/video-extend\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/video-extend \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"prompt\": \"A puppy appears\",\n    \"video_id\": \"743211632612511839\",\n    \"negative_prompt\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\":{ // Task creation parameters\n      \"external_task_id\": \"string\" // Customer"
      },
      {
        "pattern": "cURL",
        "snippet": "f API Service\nTerms of API Service\nAPI Service Level Agreement\nVideo Extension\nCreate Task\nPOST\n/v1/videos/video-extend\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/video-extend \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"prompt\": \"A puppy appears\",\n    \"video_id\": \"743211632612511839\",\n    \"negative_prompt\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\":{ // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\":"
      },
      {
        "pattern": "Parameters",
        "snippet": "atus\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\":{ // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nNote 1: Video extension refers to extending the duration of text-to-video/image-to-video results. Each extension can add 4 to 5 seconds, and the model and mode used cannot be selected; they must be the same as the source video.\nNote 2: Videos that have been extended can be extended again, but the total video duration cannot exceed 3 minutes.\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nvideo_id\nstring\nRequired\n\nVideo ID\n\nSupports video IDs generated by the text-to-video, the image-to-video and the v"
      },
      {
        "pattern": "callback_url",
        "snippet": "n' \\\n  --data '{\n    \"prompt\": \"A puppy appears\",\n    \"video_id\": \"743211632612511839\",\n    \"negative_prompt\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\":{ // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nNote 1: Video extension refers to extending the duration of text-to-video/image-to-video results. Each extension can add 4 to 5 seconds, and the model and mode used ca"
      },
      {
        "pattern": "external_task_id",
        "snippet": "/ Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\":{ // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nNote 1: Video extension refers to extending the duration of text-to-video/image-to-video results. Each extension can add 4 to 5 seconds, and the model and mode used cannot be selected; they must be the same as the source video.\nNote 2: Videos that have been extended can be extended again, but the total video duration cannot exceed 3 minutes.\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nvideo_id\nstring\nRequired\n\nVideo ID\n\nSupports video IDs generated by the text-to-video, the image-to-video and the video extension int"
      },
      {
        "pattern": "video_id",
        "snippet": "tion: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"prompt\": \"A puppy appears\",\n    \"video_id\": \"743211632612511839\",\n    \"negative_prompt\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\":{ // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nNote 1: Video extension refers to extending the duration of text-to-video/image-to-video results. Each"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported",
      "extension duration note present"
    ]
  },
  "Lip Sync": {
    "name": "Lip Sync",
    "slug": "apiReference_model__lipSync",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 14871,
    "method": "POST",
    "path": "/v1/videos/identify-face",
    "fields": [
      "prompt",
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "video_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "an error code will be returned.\nThe system checks video content—if issues are detected, an error code will be returned.\nCreate Task\nPOST\n/v1/videos/advanced-lip-sync\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/advanced-lip-sync \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"session_id\": \"850508686686064678\",\n    \"face_choose\": [\n      {\n        \"face_id\": \"0\",\n        \"sound_file\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/go-to-world.mp3\",\n        \"sound_insert_time\": 1000,\n        \"sound_start_time\": 0,\n        \"sound_end_time\": 3000,\n        \"sound_volume\": 2,\n        \"original_audio_volume\": 2\n      }\n    ],\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, u"
      },
      {
        "pattern": "cURL",
        "snippet": "cy of API Service\nTerms of API Service\nAPI Service Level Agreement\nLip-Sync\nIdentify Face\nPOST\n/v1/videos/identify-face\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/identify-face \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"video_url\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/kling20260206mp4.mp4\",\n    \"video_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"session_id\": \"id\", // Session ID\n    \"final_unit_deduction\": \"string\", // The deduction units of task\n    \"face_data\": [ //Face data list\n      {\n        \"face_id\": \"string\", // Face ID\n        \"face_image\": \"url\", // Face image URL\n        \"start_time\": 0, // Face appearance start ti"
      },
      {
        "pattern": "Parameters",
        "snippet": "ot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nsession_id\nstring\nRequired\n\nSession ID generated during the identify face API. It remains unchanged during the selection/editing process.\n\nface_choose\narray\nRequired\n\nSpecified Face for Lip-Sync\n\nIncludes Face ID, lip movement reference data, etc.\nCurrently only supports one person lip-sync.\n▾\nHide child attributes\nface_id\nstring\nRequired\n\nFace ID\n\nReturned by the "
      },
      {
        "pattern": "callback_url",
        "snippet": "e\": 3000,\n        \"sound_volume\": 2,\n        \"original_audio_volume\": 2\n      }\n    ],\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authent"
      },
      {
        "pattern": "external_task_id",
        "snippet": "\": 0,\n        \"sound_end_time\": 3000,\n        \"sound_volume\": 2,\n        \"original_audio_volume\": 2\n      }\n    ],\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication infor"
      },
      {
        "pattern": "video_id",
        "snippet": " --data '{\n    \"video_url\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/kling20260206mp4.mp4\",\n    \"video_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"session_id\": \"id\", // Session ID\n    \"final_unit_deduction\": \"string\", // The deduction units of task\n    \"face_data\": [ //Face data list\n      {\n        \"face_id\": \"string\", // Face ID\n        \"face_image\": \"url\", // Face image URL\n        \"start_time\": 0, // Face appearance start time, unit: ms\n        \"end_time\": 5200 //Face appearance end time, unit: ms\n      }\n    ]\n  }\n}\n\nIdentify faces in the video for lip-sync processing.\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API auth"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Avatar": {
    "name": "Avatar",
    "slug": "apiReference_model__avatar",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 11485,
    "method": "POST",
    "path": "/v1/videos/avatar/image2video",
    "fields": [
      "prompt",
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "\nPrepaid Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nAvatar\nCreate Task\nPOST\n/v1/videos/avatar/image2video\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/avatar/image2video \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/pink_boy.png\",\n    \"sound_file\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/go-to-world.mp3\",\n    \"prompt\": \"While talking, excitedly shaking head, finally reaching out and making a fist, deciding to set off, hopping happily\",\n    \"mode\": \"std\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \""
      },
      {
        "pattern": "cURL",
        "snippet": "y of API Service\nTerms of API Service\nAPI Service Level Agreement\nAvatar\nCreate Task\nPOST\n/v1/videos/avatar/image2video\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/avatar/image2video \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/pink_boy.png\",\n    \"sound_file\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/go-to-world.mp3\",\n    \"prompt\": \"While talking, excitedly shaking head, finally reaching out and making a fist, deciding to set off, hopping happily\",\n    \"mode\": \"std\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n  "
      },
      {
        "pattern": "Parameters",
        "snippet": "tus\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nimage\nstring\nRequired\n\nAvatar Reference Image\n\nSupport inputting image Base64 encoding or image URL (ensure accessibility).\n\nBase64 Encoding Note:\nPlease note, if you use the Base64 method, make sure all image data parameters you pass are in Base64 encoding format. When using Base64, do NOT add any prefix like data:image/png;base64,. Only provide the Base64-encoded string.\n\nCorrect:\n\niVBORw0KGgoAAAANSUhEUgAAAAUA...\n\nIncorrect:\n\ndata:image/png;base64,iVBORw"
      },
      {
        "pattern": "callback_url",
        "snippet": "ching out and making a fist, deciding to set off, hopping happily\",\n    \"mode\": \"std\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nimage\nstring\nRequired\n\n"
      },
      {
        "pattern": "external_task_id",
        "snippet": "ly shaking head, finally reaching out and making a fist, deciding to set off, hopping happily\",\n    \"mode\": \"std\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest "
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Text to Audio": {
    "name": "Text to Audio",
    "slug": "apiReference_model__textToAudio",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 10103,
    "method": "POST",
    "path": "/v1/audio/text-to-audio",
    "fields": [
      "prompt",
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "d Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nText to Audio\nCreate Task\nPOST\n/v1/audio/text-to-audio\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/audio/text-to-audio \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"prompt\": \"Fireworks sound during Chinese New Year celebration\",\n    \"duration\": 3,\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values"
      },
      {
        "pattern": "cURL",
        "snippet": " of API Service\nTerms of API Service\nAPI Service Level Agreement\nText to Audio\nCreate Task\nPOST\n/v1/audio/text-to-audio\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/audio/text-to-audio \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"prompt\": \"Fireworks sound during Chinese New Year celebration\",\n    \"duration\": 3,\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n"
      },
      {
        "pattern": "Parameters",
        "snippet": "t problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nprompt\nstring\nRequired\n\nText prompt\n\nCannot exceed 200 characters\nduration\nfloat\nRequired\n\nGenerated audio duration\n\nValue range: 3.0s - 10.0s, supports one decimal place precision\nexternal_task_id\nstring\nOptional\n\nCustomized Task ID\n\nUsers can provide a customized task ID, which will not overwrite the system-generated task ID but can be used for task queries"
      },
      {
        "pattern": "callback_url",
        "snippet": "   \"prompt\": \"Fireworks sound during Chinese New Year celebration\",\n    \"duration\": 3,\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API "
      },
      {
        "pattern": "external_task_id",
        "snippet": "cation/json' \\\n  --data '{\n    \"prompt\": \"Fireworks sound during Chinese New Year celebration\",\n    \"duration\": 3,\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthenticatio"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Video to Audio": {
    "name": "Video to Audio",
    "slug": "apiReference_model__videoToAudio",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 12067,
    "method": "POST",
    "path": "/v1/audio/video-to-audio",
    "fields": [
      "prompt",
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "video_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": " Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nVideo to Audio\nCreate Task\nPOST\n/v1/audio/video-to-audio\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/audio/video-to-audio \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"video_url\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/20fps-7s.mov\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status"
      },
      {
        "pattern": "cURL",
        "snippet": "f API Service\nTerms of API Service\nAPI Service Level Agreement\nVideo to Audio\nCreate Task\nPOST\n/v1/audio/video-to-audio\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/audio/video-to-audio \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"video_url\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/20fps-7s.mov\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succ"
      },
      {
        "pattern": "Parameters",
        "snippet": "t problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nvideo_id\nstring\nOptional\n\nThe ID of the video generated by the Kling AI\n\nEither the video_id parameter or the video_url parameter, cannot be empty or have a value at the same time.\nOnly supports videos generated within 30 days and with a duration between 3.0s and 20.0s.\nvideo_url\nstring\nOptional\n\nLink for uploaded video\n\nEither the video_id parameter or the v"
      },
      {
        "pattern": "callback_url",
        "snippet": "o_url\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/20fps-7s.mov\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to A"
      },
      {
        "pattern": "external_task_id",
        "snippet": "son' \\\n  --data '{\n    \"video_url\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/20fps-7s.mov\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentica"
      },
      {
        "pattern": "video_id",
        "snippet": "a Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nvideo_id\nstring\nOptional\n\nThe ID of the video generated by the Kling AI\n\nEither the video_id parameter or the video_url parameter, cannot be empty or have a value at the same time.\nOnly supports videos generated within 30 days and with a duration between 3.0s and 20.0s.\nvideo_url\nstring\nOptional\n\nLink for uploaded video\n\nEither the video_id parameter or the video_url parameter, cannot be empty or have a value at the same time.\nOnly .mp4/.mov formats are supported. File size does not exceed 100MB. Video duration between 3.0s and 20.0s.\nsound_effect_prompt\nstring\nOptional\n\nSound effect prompt\n\nCannot exceed 200 characters\nbgm_prompt\nstring\nOptional\n\nBGM prompt\n\nCannot exceed 200 characters\nasmr_mode\nboolean\nOptional\nDefault to false\n\nEnable ASMR mode; This mode enhances detailed sound effects and is suitable for highly immersive content scenarios\n\ntrue means enabled, false means disabled ("
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Text to Speech": {
    "name": "Text to Speech",
    "slug": "apiReference_model__TTS",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 6283,
    "method": "POST",
    "path": "/v1/audio/tts",
    "fields": [
      "prompt",
      "duration",
      "mode",
      "text",
      "voice_id"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "nfo\nPrepaid Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nTTS\nCreate Task\nPOST\n/v1/audio/tts\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/audio/tts \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"text\": \"Throughout my time in college, several memorable event left a significant impact on my life\",\n    \"voice_id\": \"oversea_male1\",\n    \"voice_language\": \"en\",\n    \"voice_speed\": 1\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_status_msg\": \"string\", // Task sta"
      },
      {
        "pattern": "cURL",
        "snippet": "ocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nTTS\nCreate Task\nPOST\n/v1/audio/tts\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/audio/tts \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"text\": \"Throughout my time in college, several memorable event left a significant impact on my life\",\n    \"voice_id\": \"oversea_male1\",\n    \"voice_language\": \"en\",\n    \"voice_speed\": 1\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_status_msg\": \"string\", // Task status information, displaying the"
      }
    ],
    "notes": [
      "async task status present"
    ]
  },
  "Voice Clone": {
    "name": "Voice Clone",
    "slug": "apiReference_model__customVoices",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 13036,
    "method": "POST",
    "path": "/v1/general/custom-voices",
    "fields": [
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "video_id",
      "text",
      "voice_id"
    ],
    "snippets": [
      {
        "pattern": "cURL",
        "snippet": "ervice\nTerms of API Service\nAPI Service Level Agreement\nCustom Voice\nCreate Custom Voice\nPOST\n/v1/general/custom-voices\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/general/custom-voices \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"video_id\": \"\",\n    \"voice_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/out.mp3\",\n    \"voice_name\": \"Custom Voice\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error Codes；Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values：submitte"
      },
      {
        "pattern": "Parameters",
        "snippet": "t problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values：submitted、processing、succeed、failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nvoice_name\nstring\nRequired\n\nVoice Name\n\nThe maximum length of text content is 20 characters\nThe voices that are no longer used after creation can be deleted through the API\nvoice_url\nstring\nOptional\n\nThe URL of voice data file\n\nSupports .mp3 / .wav audio file and .mp4 / .mov video file\nThe voice needs to be clean and free of noise, with only one type of human voice"
      },
      {
        "pattern": "callback_url",
        "snippet": "_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/out.mp3\",\n    \"voice_name\": \"Custom Voice\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error Codes；Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values：submitted、processing、succeed、failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authe"
      },
      {
        "pattern": "external_task_id",
        "snippet": "\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values：submitted、processing、succeed、failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nvoice_name\nstring\nRequired\n\nVoice Name\n\nThe maximum length of text content is 20 characters\nThe voices that are no longer used after creation can be deleted through the API\nvoice_url\nstring\nOptional\n\nThe URL of voice data file\n\nSupports .mp3 / .wav audio file and .mp4 / .mov video file\nThe voice needs to be clean and free of noise, with only one type of human voice present, with a d"
      },
      {
        "pattern": "video_id",
        "snippet": "om-voices \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"video_id\": \"\",\n    \"voice_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/out.mp3\",\n    \"voice_name\": \"Custom Voice\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error Codes；Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values：submitted、processing、succeed、failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit ms\n  }\n}\nRequest Header\nContent-Type"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Image Recognize": {
    "name": "Image Recognize",
    "slug": "apiReference_model__imageRecognize",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 6758,
    "method": "POST",
    "path": "/v1/videos/image-recognize",
    "fields": [
      "duration",
      "mode",
      "text"
    ],
    "snippets": [
      {
        "pattern": "cURL",
        "snippet": "ervice\nTerms of API Service\nAPI Service Level Agreement\nImage Recognize\nImage Recognize\nPOST\n/v1/videos/image-recognize\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/image-recognize \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"final_unit_deduction\": \"string\", //  The deduction units of task\n    \"task_result\": {\n      \"images\": [\n        {\n          \"type\": \"object_seg\", // Identification of subject recognition results\n          \"is_contain\": true, // Has the subject been identified; Boolean value\n          \"url\": \"string\" //URL for gen"
      },
      {
        "pattern": "Parameters",
        "snippet": "se64 encoding or image URL (ensure accessibility).\n\nPlease note, if you use the Base64 method, make sure all image data parameters you pass are in Base64 encoding format. When submitting data, do not add any prefixes to the Base64-encoded string, such as data:image/png;base64,. The correct parameter format should be the Base64-encoded string itself. Please provide only the Base64-encoded string portion so that the system can correctly process and parse your data.\n\nSupported image formats: .jpg / .jpeg / .png. The image file size cannot exceed 10MB, and the width and height dimensions of the image shall not be less than 300px, and the aspect ratio of the image should be between 1:2.5 ~ 2.5:1.\n\nPrevious chapter：Voice Clone\nNext chapter：Element\nThe Kling 3.0 Series Models API is Now Fully Available\n– All in One, One for All！\n\nModels Available in This Release\n\nKling 3.0 Motion Control, Kling Video 3.0, Kling Video 3.0 Omni, Kling Image 3.0, Kling Image 3.0 Omni\n\nRefer to <Kling AI Series 3.0 Model API Specifi"
      }
    ],
    "notes": []
  },
  "Element": {
    "name": "Element",
    "slug": "apiReference_model__element",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 16416,
    "method": "POST",
    "path": "/v1/general/advanced-custom-elements",
    "fields": [
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "image_list",
      "text",
      "voice_id"
    ],
    "snippets": [
      {
        "pattern": "cURL",
        "snippet": "at the customized task ID must be unique within a single user account.\n\nInvocation examples\nCreate Multi-Image Elements\ncurl --location 'https://xxx/v1/general/advanced-custom-elements/' \\\n--header 'Authorization: Bearer xxx' \\\n--header 'Content-Type: application/json\\' \\\n--data '{\n    \"element_name\": \"xxx\",\n    \"element_description\": \"xxx\",\n    \"reference_type\": \"image_refer\",\n    \"element_image_list\": {\n      \"frontal_image\": \"xxx\",\n      \"refer_images\": [\n        {\"image_url\": \"xxx\"},\n        {\"image_url\": \"xxx\"}\n      ]\n    },\n    \"element_voice_id\": string,\n    \"callback_url\": \"xxx\",\n    \"external_task_id\": \"\",\n     \"tag_list\": [\n        {\n            \"tag_id\": \"xxx\"\n        }\n    ]\n  }'\nCreate Video Character Elements\ncurl --location 'https://xxx/v1/general/advanced-custom-elements/' \\\n--header 'Authorization: Bearer xxx' \\\n--header 'Content-Type: application/json\\' \\\n--data '{\n    \"element_name\": \"xxx\",\n    \"element_description\": \"xxx\",\n    \"reference_type\": \"video_refer\",\n    \"element_video_list\":"
      },
      {
        "pattern": "Parameters",
        "snippet": "ubleshooting\n  \"data\": {\n    \"task_id\": \"string\", //Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"task_status\": \"string\", //Task status: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, //Task creation time, Unix timestamp, ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, ms\n  }\n}\n💡\n\nThe service related to creating entities has been upgraded to a brand new version. If you need to browse the old version, please proceed to:Kling AI (OLD VERSION) ELEMENTS API Specification\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nelement_name\nstring\nRequired\n\nElement Name\n\nMust not exceed 20 characters.\n\nelement_description\nstring\nRequired\n\nElement Description\n\nMust not exceed 100 characters.\n\nreference_type\nstring\nRequire"
      },
      {
        "pattern": "callback_url",
        "snippet": "g_id\ttag_name\no_101\tHottest\no_102\tCharacter\no_103\tAnimal\no_104\tItem\no_105\tCostume\no_106\tScene\no_107\tEffect\no_108\tOthers\ncallback_url\nstring\nOptional\n\nThe callback notification address for the result of this task. If configured, the server will actively notify when the task status changes.\n\nFor the specific message schema, see Callback Protocol\nexternal_task_id\nstring\nOptional\n\nCustomized Task ID. Users can provide a customized task ID, which will not overwrite the system-generated task ID but can be used for task queries. Please note that the customized task ID must be unique within a single user account.\n\nInvocation examples\nCreate Multi-Image Elements\ncurl --location 'https://xxx/v1/general/advanced-custom-elements/' \\\n--header 'Authorization: Bearer xxx' \\\n--header 'Content-Type: application/json\\' \\\n--data '{\n    \"element_name\": \"xxx\",\n    \"element_description\": \"xxx\",\n    \"reference_type\": \"image_refer\",\n    \"element_image_list\": {\n      \"frontal_image\": \"xxx\",\n      \"refer_images\": [\n        {\"image"
      },
      {
        "pattern": "external_task_id",
        "snippet": "ta\": {\n    \"task_id\": \"string\", //Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"task_status\": \"string\", //Task status: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, //Task creation time, Unix timestamp, ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, ms\n  }\n}\n💡\n\nThe service related to creating entities has been upgraded to a brand new version. If you need to browse the old version, please proceed to:Kling AI (OLD VERSION) ELEMENTS API Specification\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nelement_name\nstring\nRequired\n\nElement Name\n\nMust not exceed 20 characters.\n\nelement_description\nstring\nRequired\n\nElement Description\n\nMust not exceed 100 characters.\n\nreference_type\nstring\nRequired\n\nReference Metho"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Video Effects": {
    "name": "Video Effects",
    "slug": "apiReference_model__videoEffects",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 18656,
    "method": "POST",
    "path": "/v1/videos/effects",
    "fields": [
      "prompt",
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "d Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nVideo Effects\nCreate Task\nPOST\n/v1/videos/effects\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/effects \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"effect_scene\": \"color_mixing\",\n    \"input\": {\n      \"image\": \"https://p4-kling.klingai.com/kcdn/cdn-kcdn112452/kling-op/effects_raw_pic/color_mixing.jpeg\"\n    }\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, //Error codes；Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", //Error information\n  \"request_id\": \"string\", //Request ID, generated by the system\n  \"data\":{\n    \"task_id\": \"string\", //Task ID, generated by the system\n    \"task_status\": \"string\", //Task status, Enum values：submitted、processing、succeed、failed\n    \"task_info\":{ //Task creation parameters\n        \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    "
      },
      {
        "pattern": "cURL",
        "snippet": "olicy of API Service\nTerms of API Service\nAPI Service Level Agreement\nVideo Effects\nCreate Task\nPOST\n/v1/videos/effects\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/videos/effects \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"effect_scene\": \"color_mixing\",\n    \"input\": {\n      \"image\": \"https://p4-kling.klingai.com/kcdn/cdn-kcdn112452/kling-op/effects_raw_pic/color_mixing.jpeg\"\n    }\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, //Error codes；Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", //Error information\n  \"request_id\": \"string\", //Request ID, generated by the system\n  \"data\":{\n    \"task_id\": \"string\", //Task ID, generated by the system\n    \"task_status\": \"string\", //Task status, Enum values：submitted、processing、succeed、failed\n    \"task_info\":{ //Task creation parameters\n        \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, //Task "
      },
      {
        "pattern": "Parameters",
        "snippet": "ask_status\": \"string\", //Task status, Enum values：submitted、processing、succeed、failed\n    \"task_info\":{ //Task creation parameters\n        \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, //Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit ms\n  }\n}\n\nTotal of 229 video effects are available. You can achieve different effects by calling effect_scene. For detailed list, please refer to: Video Effects Center\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\neffect_scene\nstring\nRequired\n\nScene Name\n\nEnum values: flash_drive, shush_my_dreams, french_elegance, finger_swipe, advent_of_flora, smooth_transition, kiss_pro, raid_check, snow_night_kiss, eternal_kiss, fortune_in_motion, chinese_trend, sedan_chair_dance, skyfall, good_luck_dance, laicai_dance, yan"
      },
      {
        "pattern": "Request Example",
        "snippet": "ed task ID, but supports querying tasks by this ID\nPlease note that it must be unique for each user\nSingle-image Effect Request Example\n{\n  \"effect_scene\": \"pet_lion\",\n  \"input\":{\n    \"image\":\"https://p4-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452\"\n  }\n}\nDual-character Effect Request Example\n{\n  \"effect_scene\": \"hug_pro\",\n  \"input\": {\n    \"images\": [\n      \"https://example.com/image1.jpg\",\n      \"https://example.com/image2.jpg\"\n    ]\n  }\n}\nQuery Task (Single)\nGET\n/v1/videos/effects/{id}\ncURL\nCopy\nCollapse\ncurl --request GET \\\n  --url https://api-singapore.klingai.com/v1/videos/effects/{task_id} \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    "
      },
      {
        "pattern": "callback_url",
        "snippet": "AAAUA...\nSupported image formats: .jpg / .jpeg / .png\nFile size: ≤10MB, dimensions: ≥300px, aspect ratio: 1:2.5 ~ 2.5:1\ncallback_url\nstring\nOptional\n\nThe callback notification address for the result of this task. If configured, the server will actively notify when the task status changes.\n\nFor specific message schema, see Callback Protocol\nexternal_task_id\nstring\nOptional\n\nCustomized Task ID\n\nUser-defined task ID. It will not override the system-generated task ID, but supports querying tasks by this ID\nPlease note that it must be unique for each user\nSingle-image Effect Request Example\n{\n  \"effect_scene\": \"pet_lion\",\n  \"input\":{\n    \"image\":\"https://p4-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452\"\n  }\n}\nDual-character Effect Request Example\n{\n  \"effect_scene\": \"hug_pro\",\n  \"input\": {\n    \"images\": [\n      \"https://example.com/image1.jpg\",\n      \"https://example.com/image2.jpg\"\n    ]\n  }\n}\nQuery Task (Single)\nGET\n/v1/videos/effects/{id}\ncURL\nCopy\nCollapse\nc"
      },
      {
        "pattern": "external_task_id",
        "snippet": "\", //Task status, Enum values：submitted、processing、succeed、failed\n    \"task_info\":{ //Task creation parameters\n        \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, //Task creation time, Unix timestamp, unit ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit ms\n  }\n}\n\nTotal of 229 video effects are available. You can achieve different effects by calling effect_scene. For detailed list, please refer to: Video Effects Center\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\neffect_scene\nstring\nRequired\n\nScene Name\n\nEnum values: flash_drive, shush_my_dreams, french_elegance, finger_swipe, advent_of_flora, smooth_transition, kiss_pro, raid_check, snow_night_kiss, eternal_kiss, fortune_in_motion, chinese_trend, sedan_chair_dance, skyfall, good_luck_dance, laicai_dance, yangge_dance, color_mix"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Image Omni": {
    "name": "Image Omni",
    "slug": "apiReference_model__OmniImage",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 13852,
    "method": "POST",
    "path": "/v1/images/omni-image",
    "fields": [
      "model_name",
      "prompt",
      "duration",
      "mode",
      "aspect_ratio",
      "callback_url",
      "external_task_id",
      "image_list",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "paid Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nOmni-Image\nCreate Task\nPOST\n/v1/images/omni-image\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/images/omni-image \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-image-o1\",\n    \"prompt\": \"Merge all the people in the images into the <<<object_1>>> image\",\n    \"element_list\": [\n        {\n            \"element_id\": 829836802793406551\n        }\n    ],\n    \"image_list\": [\n        {\n            \"image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-4.png\"\n        },\n        {\n            \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/video_effects/1.png\"\n        },\n        {\n            \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/video_effects/4.png\"\n        }\n    ],\n    \"resolution\": \"2k\",\n    \"n\": 1,\n    \""
      },
      {
        "pattern": "cURL",
        "snippet": "olicy of API Service\nTerms of API Service\nAPI Service Level Agreement\nOmni-Image\nCreate Task\nPOST\n/v1/images/omni-image\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/images/omni-image \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-image-o1\",\n    \"prompt\": \"Merge all the people in the images into the <<<object_1>>> image\",\n    \"element_list\": [\n        {\n            \"element_id\": 829836802793406551\n        }\n    ],\n    \"image_list\": [\n        {\n            \"image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-4.png\"\n        },\n        {\n            \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/video_effects/1.png\"\n        },\n        {\n            \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/video_effects/4.png\"\n        }\n    ],\n    \"resolution\": \"2k\",\n    \"n\": 1,\n    \"aspect_ratio\": \"3:2\"\n  }'\n200\nCopy\nColl"
      },
      {
        "pattern": "Parameters",
        "snippet": "nd troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, system-generated\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nmodel_name\nstring\nOptional\nDefault to kling-image-o1\n\nModel Name\n\nEnum values：\nkling-image-o1\nkling-v3-omni\nprompt\nstring\nRequired\n\nText prompt words, which can include positive and negative descriptions\n\nThe prompt words can be templated to meet different image generation needs\nMust not exceed 2,500 characters\nSpecify an image in the format of <<<>>>, such as <<<i"
      },
      {
        "pattern": "callback_url",
        "snippet": "ed\": boolean } \ntrue: generate watermarked result, false: do not generate\nCustom watermarks are not currently supported\ncallback_url\nstring\nOptional\n\nThe callback notification address for the result of this task. If configured, the server will actively notify when the task status changes\n\nFor the specific message schema, see Callback Protocol\nexternal_task_id\nstring\nOptional\n\nCustomized Task ID\n\nUser-defined task ID. It will not override the system-generated task ID, but supports querying tasks by this ID\nPlease note that it must be unique for each user\nInvocation examples\nImage generation with element\ncurl --location 'https://xxx/v1/images/generations' \\\n--header 'Authorization: Bearer xxx' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"model_name\": \"kling-v3-omni\",\n    \"prompt\": \"Generate a recommended cover for each subject <<element_1>> based on the style of the reference image <<image_1>>\",\n    \"element_list\": [\n      {\n        \"element_id\": \"160\"\n      },\n      {\n        \"element_id\": "
      },
      {
        "pattern": "external_task_id",
        "snippet": "\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, system-generated\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nmodel_name\nstring\nOptional\nDefault to kling-image-o1\n\nModel Name\n\nEnum values：\nkling-image-o1\nkling-v3-omni\nprompt\nstring\nRequired\n\nText prompt words, which can include positive and negative descriptions\n\nThe prompt words can be templated to meet different image generation needs\nMust not exceed 2,500 characters\nSpecify an image in the format of <<<>>>, such as <<<image_1>>>\nThe scop"
      },
      {
        "pattern": "model_name",
        "snippet": "mni-image \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-image-o1\",\n    \"prompt\": \"Merge all the people in the images into the <<<object_1>>> image\",\n    \"element_list\": [\n        {\n            \"element_id\": 829836802793406551\n        }\n    ],\n    \"image_list\": [\n        {\n            \"image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-4.png\"\n        },\n        {\n            \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/video_effects/1.png\"\n        },\n        {\n            \"image\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/video_effects/4.png\"\n        }\n    ],\n    \"resolution\": \"2k\",\n    \"n\": 1,\n    \"aspect_ratio\": \"3:2\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in Error codes\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, system-generated, used for tracking requests and "
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Image Generation": {
    "name": "Image Generation",
    "slug": "apiReference_model__imageGeneration",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 13225,
    "method": "POST",
    "path": "/v1/images/generations",
    "fields": [
      "model_name",
      "prompt",
      "negative_prompt",
      "duration",
      "mode",
      "aspect_ratio",
      "callback_url",
      "external_task_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "esource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nImage Generation\nCreate Task\nPOST\n/v1/images/generations\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/images/generations \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v2-1\",\n    \"prompt\": \"Generate a Pixar-style puppy\",\n    \"negative_prompt\": \"\",\n    \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png\",\n    \"n\": 2,\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, for tracking and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status: submitted, processing, succeed, failed\n    \"t"
      },
      {
        "pattern": "cURL",
        "snippet": "f API Service\nTerms of API Service\nAPI Service Level Agreement\nImage Generation\nCreate Task\nPOST\n/v1/images/generations\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/images/generations \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v2-1\",\n    \"prompt\": \"Generate a Pixar-style puppy\",\n    \"negative_prompt\": \"\",\n    \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png\",\n    \"n\": 2,\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, for tracking and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status: submitted, processing, succeed, failed\n    \"task_info\": { // Task creation parameters"
      },
      {
        "pattern": "Parameters",
        "snippet": "    \"task_status\": \"string\", // Task status: submitted, processing, succeed, failed\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, ms\n  }\n}\n💡\n\nPlease note that in order to maintain naming consistency, the original model field has been changed to model_name, so in the future, please use this field to specify the version of the model that needs to be called.\nAt the same time, we keep the behavior forward-compatible. If you continue to use the original model field, it will not have any impact on the interface call, there will not be any exception, which is equivalent to the default behavior when model_name is empty (i.e., call the V1 model).\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refe"
      },
      {
        "pattern": "callback_url",
        "snippet": " \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png\",\n    \"n\": 2,\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, for tracking and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status: submitted, processing, succeed, failed\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, ms\n  }\n}\n💡\n\nPlease note that in order to maintain naming consistency, the original model field has been changed to model_name, so in the future, please use this field to specify the version of the model that needs to be called.\nAt t"
      },
      {
        "pattern": "external_task_id",
        "snippet": "ve_prompt\": \"\",\n    \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png\",\n    \"n\": 2,\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, for tracking and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status: submitted, processing, succeed, failed\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, ms\n  }\n}\n💡\n\nPlease note that in order to maintain naming consistency, the original model field has been changed to model_name, so in the future, please use this field to specify the version of the model t"
      },
      {
        "pattern": "model_name",
        "snippet": "nerations \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v2-1\",\n    \"prompt\": \"Generate a Pixar-style puppy\",\n    \"negative_prompt\": \"\",\n    \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png\",\n    \"n\": 2,\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n}'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, for tracking and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status: submitted, processing, succeed, failed\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, "
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Reference to Image": {
    "name": "Reference to Image",
    "slug": "apiReference_model__multiImageToImage",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 12501,
    "method": "POST",
    "path": "/v1/images/multi-image2image",
    "fields": [
      "model_name",
      "prompt",
      "negative_prompt",
      "duration",
      "mode",
      "aspect_ratio",
      "callback_url",
      "external_task_id",
      "image_list",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "rce Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nMulti-Image to Image\nCreate Task\nPOST\n/v1/images/multi-image2image\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/images/multi-image2image \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v2-1\",\n    \"prompt\": \"Wearing a flowing red dress on the grassland, in Ghibli style.\",\n    \"negative_prompt\": \"\",\n    \"subject_image_list\": [\n      { \"subject_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\" },\n      { \"subject_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\" }\n    ],\n    \"scene_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/background.jpeg\",\n    \"style_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/16x9_jipuli.png\",\n    \"n\": 2,\n    \"aspect_ratio\": \"9:16\"\n  }'\n200\nCopy\n"
      },
      {
        "pattern": "cURL",
        "snippet": "ice\nTerms of API Service\nAPI Service Level Agreement\nMulti-Image to Image\nCreate Task\nPOST\n/v1/images/multi-image2image\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/images/multi-image2image \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v2-1\",\n    \"prompt\": \"Wearing a flowing red dress on the grassland, in Ghibli style.\",\n    \"negative_prompt\": \"\",\n    \"subject_image_list\": [\n      { \"subject_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\" },\n      { \"subject_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\" }\n    ],\n    \"scene_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/background.jpeg\",\n    \"style_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/16x9_jipuli.png\",\n    \"n\": 2,\n    \"aspect_ratio\": \"9:16\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specifi"
      },
      {
        "pattern": "Parameters",
        "snippet": "bleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\n\nGenerate images based on multiple reference images (subject, scene, style).\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nmodel_name\nstring\nOptional\nDefault to kling-v2\n\nModel Name\n\nEnum values：\nkling-v2\nkling-v2-1\nprompt\nstring\nOptional\n\nPositive text prompt\n\nCannot exceed 2500 characters\nsubject_image_list\narray\nRequired\n\nSubject Reference Images\n\nSupport up to 4 images, at least 1 image, using key:value f"
      },
      {
        "pattern": "callback_url",
        "snippet": "ed\": boolean } \ntrue: generate watermarked result, false: do not generate\nCustom watermarks are not currently supported\ncallback_url\nstring\nOptional\n\nThe callback notification address for the result of this task. If configured, the server will actively notify when the task status changes\n\nThe specific message schema of the notification can be found in Callback Protocol\nexternal_task_id\nstring\nOptional\n\nCustomized Task ID\n\nUser-defined task ID. It will not override the system-generated task ID, but supports querying tasks by this ID\nPlease note that it must be unique for each user\nQuery Task (Single)\nGET\n/v1/images/multi-image2image/{id}\ncURL\nCopy\nCollapse\ncurl --request GET \\\n  --url https://api-singapore.klingai.com/v1/images/multi-image2image/{id} \\\n  --header 'Authorization: Bearer <token>'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system\n  \"data\": {\n    \"tas"
      },
      {
        "pattern": "external_task_id",
        "snippet": "a\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //User-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\n\nGenerate images based on multiple reference images (subject, scene, style).\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nmodel_name\nstring\nOptional\nDefault to kling-v2\n\nModel Name\n\nEnum values：\nkling-v2\nkling-v2-1\nprompt\nstring\nOptional\n\nPositive text prompt\n\nCannot exceed 2500 characters\nsubject_image_list\narray\nRequired\n\nSubject Reference Images\n\nSupport up to 4 images, at least 1 image, using key:value format as follows:\n"
      },
      {
        "pattern": "model_name",
        "snippet": "age2image \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kling-v2-1\",\n    \"prompt\": \"Wearing a flowing red dress on the grassland, in Ghibli style.\",\n    \"negative_prompt\": \"\",\n    \"subject_image_list\": [\n      { \"subject_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\" },\n      { \"subject_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png\" }\n    ],\n    \"scene_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/background.jpeg\",\n    \"style_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/16x9_jipuli.png\",\n    \"n\": 2,\n    \"aspect_ratio\": \"9:16\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used for tracking requests and troubleshooting\n  \"data\": {\n    \"task_id\""
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Extend Image": {
    "name": "Extend Image",
    "slug": "apiReference_model__imageExpansion",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 13665,
    "method": "POST",
    "path": "/v1/images/editing/expand",
    "fields": [
      "prompt",
      "duration",
      "mode",
      "aspect_ratio",
      "callback_url",
      "external_task_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nImage Expansion\nCreate Task\nPOST\n/v1/images/editing/expand\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/images/editing/expand \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"up_expansion_ratio\": 0.1495,\n    \"down_expansion_ratio\": 0.1495,\n    \"left_expansion_ratio\": 0.6547,\n    \"right_expansion_ratio\": 0.6547,\n    \"prompt\": \"\",\n    \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png\",\n    \"n\": 2,\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in Error code\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Tas"
      },
      {
        "pattern": "cURL",
        "snippet": "API Service\nTerms of API Service\nAPI Service Level Agreement\nImage Expansion\nCreate Task\nPOST\n/v1/images/editing/expand\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/images/editing/expand \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"up_expansion_ratio\": 0.1495,\n    \"down_expansion_ratio\": 0.1495,\n    \"left_expansion_ratio\": 0.6547,\n    \"right_expansion_ratio\": 0.6547,\n    \"prompt\": \"\",\n    \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png\",\n    \"n\": 2,\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in Error code\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_"
      },
      {
        "pattern": "Parameters",
        "snippet": "t problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit: ms\n  }\n}\n\nExpand the image in any direction based on the original image.\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nimage\nstring\nRequired\n\nReference Image\n\nSupports image input as either Base64-encoded string or URL (ensure accessibility)\nImportant: When using Base64, do NOT add any prefix like data:image/png;base64,. Submit only the raw Base64 string.\nCorrect Base64 format:\niVBORw0KGgoAAAANSUhEUgAAAAUA...\nIn"
      },
      {
        "pattern": "callback_url",
        "snippet": "ed\": boolean } \ntrue: generate watermarked result, false: do not generate\nCustom watermarks are not currently supported\ncallback_url\nstring\nOptional\n\nThe callback notification address for the result of this task. If configured, the server will actively notify when the task status changes.\n\nFor specific message schema, see Callback Protocol\nexternal_task_id\nstring\nOptional\n\nCustomized Task ID\n\nWill not overwrite system-generated task ID, but supports querying task by this ID\nMust be unique within a single user account\nExample code\nimport math\n\ndef calculate_expansion_ratios(width, height, area_multiplier, aspect_ratio):\n    \"\"\"\n    Calculate top/bottom/left/right expansion ratios for image outpainting.\n    \n    Parameters:\n    - width: Original image width\n    - height: Original image height\n    - area_multiplier: Multiplier for the outpainted area relative to original image\n    - aspect_ratio: Width/height ratio for the outpainted area（width/height）\n    \n    Returns:\n    - Formatted string with 4 decimal "
      },
      {
        "pattern": "external_task_id",
        "snippet": "  \"prompt\": \"\",\n    \"image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png\",\n    \"n\": 2,\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in Error code\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, is used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_info\": { // Task creation parameters\n      \"external_task_id\": \"string\" // Customer-defined task ID\n    },\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, unit: ms\n  }\n}\n\nExpand the image in any direction based on the original image.\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthori"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "AI Multi-Shot": {
    "name": "AI Multi-Shot",
    "slug": "apiReference_model__aiMultiShot",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 10017,
    "method": "POST",
    "path": "/v1/general/ai-multi-shot",
    "fields": [
      "prompt",
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "d Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nAI Multi-Shot\nCreate Task\nPOST\n/v1/general/ai-multi-shot\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/general/ai-multi-shot \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"element_frontal_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\": { //Task creation parameters\n      \"exter"
      },
      {
        "pattern": "cURL",
        "snippet": "f API Service\nTerms of API Service\nAPI Service Level Agreement\nAI Multi-Shot\nCreate Task\nPOST\n/v1/general/ai-multi-shot\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/general/ai-multi-shot \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"element_frontal_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //Customer-defined t"
      },
      {
        "pattern": "Parameters",
        "snippet": "atus\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nelement_frontal_image\nstring\nRequired\n\nThe frontal side of element image\n\nSupports inputting image Base64 encoding or image URL (ensure accessibility).\nSupported image formats: .jpg / .jpeg / .png\nImage file size cannot exceed 10MB, and the width and height dimensions shall not be less than 300px, and the aspect ratio should be between 1:2.5 ~ 2.5:1\ncallback_url\nstring\nOptional\n\nThe callback notification address for the result of this task. If configured, "
      },
      {
        "pattern": "callback_url",
        "snippet": "_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authenti"
      },
      {
        "pattern": "external_task_id",
        "snippet": "data '{\n    \"element_frontal_image\": \"https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png\",\n    \"external_task_id\": \"\",\n    \"callback_url\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error code; Specific definitions can be found in \"Error Code\"\n  \"message\": \"string\", // Error message\n  \"request_id\": \"string\", // Request ID, generated by the system, used to track requests and troubleshoot problems\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status, Enum values: submitted, processing, succeed, failed\n    \"task_info\": { //Task creation parameters\n      \"external_task_id\": \"string\" //Customer-defined task ID\n    },\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, unit: ms\n    \"updated_at\": 1722769557708 //Task update time, Unix timestamp, unit: ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication inform"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Virtual Try-On": {
    "name": "Virtual Try-On",
    "slug": "apiReference_model__virtualTryOn",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 10811,
    "method": "POST",
    "path": "/v1/images/kolors-virtual-try-on",
    "fields": [
      "model_name",
      "prompt",
      "duration",
      "mode",
      "callback_url",
      "external_task_id",
      "text"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": " Resource Packs\nProtocols\nPrivacy Policy of API Service\nTerms of API Service\nAPI Service Level Agreement\nVirtual Try-On\nCreate Task\nPOST\n/v1/images/kolors-virtual-try-on\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/images/kolors-virtual-try-on \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kolors-virtual-try-on-v1-5\",\n    \"human_image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/tryon-human.webp\",\n    \"cloth_image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/suite.webp\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, for tracking and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string"
      },
      {
        "pattern": "cURL",
        "snippet": "rvice\nTerms of API Service\nAPI Service Level Agreement\nVirtual Try-On\nCreate Task\nPOST\n/v1/images/kolors-virtual-try-on\ncURL\nCopy\nCollapse\ncurl --request POST \\\n  --url https://api-singapore.klingai.com/v1/images/kolors-virtual-try-on \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kolors-virtual-try-on-v1-5\",\n    \"human_image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/tryon-human.webp\",\n    \"cloth_image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/suite.webp\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, for tracking and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status: submitted, processing, succeed,"
      },
      {
        "pattern": "Parameters",
        "snippet": "e URL (ensure accessibility)\n\nBase64 Encoding Note:\nPlease note, if you use the Base64 method, make sure all image data parameters you pass are in Base64 encoding format. When using Base64, do NOT add any prefix like data:image/png;base64,. Only provide the Base64-encoded string.\n\nCorrect:\n\niVBORw0KGgoAAAANSUhEUgAAAAUA...\n\nIncorrect:\n\ndata:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...\nSupported image formats: .jpg / .jpeg / .png\nFile size: ≤10MB, dimensions: min 300px\nThe kolors-virtual-try-on-v1-5 model not only supports single clothing input, but also supports \"upper + lower\" combination input:\nInput a single clothing image (upper, lower, or dress) → Generate a try-on image of the single item\nInput a combination clothing image (merge multiple items into one image with white background):\n\"upper + lower\" → Success\n\"upper + upper\" → Fails\n\"lower + lower\" → Fails\n\"dress + dress\" → Fails\n\"upper + dress\" → Fails\n\"lower + dress\" → Fails\n\ncallback_url\nstring\nOptional\n\nThe callback notification address for th"
      },
      {
        "pattern": "callback_url",
        "snippet": "tryon-human.webp\",\n    \"cloth_image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/suite.webp\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, for tracking and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nmodel_name\nstring\nOptional\nDefault to kolors-virtual-try-on-v1\n\nModel Name\n\nEnum values：\nkolors-virtual-try-on-v1\n"
      },
      {
        "pattern": "external_task_id",
        "snippet": "cloth_image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/suite.webp\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, for tracking and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nRequest Body\nmodel_name\nstring\nOptional\nDefault to kolors-virtual-try-on-v1\n\nModel Name\n\nEnum values：\nkolors-virtual-try-on-v1\nkolors-virtual-try-on-v1"
      },
      {
        "pattern": "model_name",
        "snippet": "al-try-on \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model_name\": \"kolors-virtual-try-on-v1-5\",\n    \"human_image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/tryon-human.webp\",\n    \"cloth_image\": \"https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/suite.webp\",\n    \"callback_url\": \"\",\n    \"external_task_id\": \"\"\n  }'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, for tracking and troubleshooting\n  \"data\": {\n    \"task_id\": \"string\", // Task ID, generated by the system\n    \"task_status\": \"string\", // Task status: submitted, processing, succeed, failed\n    \"created_at\": 1722769557708, // Task creation time, Unix timestamp, ms\n    \"updated_at\": 1722769557708 // Task update time, Unix timestamp, ms\n  }\n}\nRequest Header\nContent-Type\nstring\nRequired\nDefault to applicati"
      }
    ],
    "notes": [
      "async task status present",
      "callback supported",
      "client correlation id supported"
    ]
  },
  "Query user info": {
    "name": "Query user info",
    "slug": "apiReference_accountInfoInquiry",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 5584,
    "fields": [
      "duration",
      "mode",
      "text"
    ],
    "snippets": [
      {
        "pattern": "cURL",
        "snippet": "ent\nAccount Information Inquiry\nQuery Resource Package List and Remaining Quantity under the Account\nGET\n/account/costs\ncURL\nPython\nCopy\nCollapse\ncurl --request GET \\\n  --url 'https://api-singapore.klingai.com/account/costs?start_time=1726124664368&end_time=1727366400000' \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json'\n200\nCopy\nCollapse\n{\n  \"code\": 0, // Error codes; specific definitions see Error codes\n  \"message\": \"string\", // Error information\n  \"request_id\": \"string\", // Request ID, generated by the system, for tracking and troubleshooting\n  \"data\": {\n    \"code\": 0, // Error codes; specific definitions see Error codes\n    \"msg\": \"string\", // Error information\n    \"resource_pack_subscribe_infos\": [ // Resource package list\n      {\n        \"resource_pack_name\": \"Video Generation - 10,000 entries\", // Resource package name\n        \"resource_pack_id\": \"509f3fd3d4ab4a3f9eec5db27aa44f27\", // Resource package ID\n        \"resource_pack_type\": \"decreasing_total\", // R"
      },
      {
        "pattern": "Parameters",
        "snippet": "on\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nQuery Parameters\nstart_time\nint\nRequired\n\nQuery start time, Unix timestamp, unit: ms\n\nend_time\nint\nRequired\n\nQuery end time, Unix timestamp, unit: ms\n\nresource_pack_name\nstring\nOptional\n\nResource package name, used to precisely specify a resource package to query\n\nPrevious chapter：Virtual Try-On\nNext chapter：Billing Info\nThe Kling 3.0 Series Models API is Now Fully Available\n– All in One, One for All！\n\nModels Available in This Release\n\nKling 3.0 Motion Control, Kling Video 3.0, Kling Video 3.0 Omni, Kling Image 3.0, Kling Image 3.0 Omni\n\nRefer to <Kling AI Series 3.0 Model API Specification>\n\nKey Highlights of the Models\n\n3.0 All-in-One: A unified model for multi-modal input and output.\n\nMost powerful consistency across the universe: Subject consistency (supports cameo, subject with voice control, i2v + subject) and text consistency.\nNarrative control at your fingertips: More freedom, precisio"
      },
      {
        "pattern": "QPS",
        "snippet": "ows you to query the list and balance of resource packages under your account. Please note to control the request rate (QPS<=1)\n\nRequest Header\nContent-Type\nstring\nRequired\nDefault to application/json\n\nData Exchange Format\n\nAuthorization\nstring\nRequired\n\nAuthentication information, refer to API authentication\n\nQuery Parameters\nstart_time\nint\nRequired\n\nQuery start time, Unix timestamp, unit: ms\n\nend_time\nint\nRequired\n\nQuery end time, Unix timestamp, unit: ms\n\nresource_pack_name\nstring\nOptional\n\nResource package name, used to precisely specify a resource package to query\n\nPrevious chapter：Virtual Try-On\nNext chapter：Billing Info\nThe Kling 3.0 Series Models API is Now Fully Available\n– All in One, One for All！\n\nModels Available in This Release\n\nKling 3.0 Motion Control, Kling Video 3.0, Kling Video 3.0 Omni, Kling Image 3.0, Kling Image 3.0 Omni\n\nRefer to <Kling AI Series 3.0 Model API Specification>\n\nKey Highlights of the Models\n\n3.0 All-in-One: A unified model for multi-modal input and output.\n\nMost powerf"
      }
    ],
    "notes": []
  },
  "Billing Info": {
    "name": "Billing Info",
    "slug": "productBilling_billingMethod",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 3727,
    "fields": [
      "duration",
      "mode",
      "text"
    ],
    "snippets": [],
    "notes": []
  },
  "Prepaid Resource Packs": {
    "name": "Prepaid Resource Packs",
    "slug": "productBilling_prePaidResourcePackage",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 14109,
    "fields": [
      "duration",
      "mode",
      "text"
    ],
    "snippets": [],
    "notes": []
  },
  "Changelog": {
    "name": "Changelog",
    "slug": "apiReference_updateNotice",
    "title": "Kling AI: Next-Gen AI Video & AI Image Generator",
    "textLength": 25756,
    "fields": [
      "model_name",
      "prompt",
      "negative_prompt",
      "duration",
      "mode",
      "external_task_id",
      "text",
      "voice_id"
    ],
    "snippets": [
      {
        "pattern": "Create Task",
        "snippet": "”: 7 types available, jelly_press, jelly_slice, jelly_squish, jelly_jiggle, pixelpixel, yearbook, instant_film\nincludes create task, query task (single), and query task (list) interfaces\n\nMulti-Elements | Newly launched\n\nSupport adding (addition), swapping (swap), and removing (removal) elements to existing videos\nWhen using, it is necessary to initialize the video and tag it before performing operations such as creating tasks\n2025.7.7\n\nVideo Generation - Video Effects | New Feature\n\nLaunch of “Single Image Effects”: 2 types available, anime_figure, rocketrocket\nincludes create task, query task (single), and query task (list) interfaces\n2025.6.30\n\nLip-Sync | New version new capabilities\n\nSupports increasing the maximum video duration from 10 seconds to 60 seconds\nGenerating videos takes as little as 2 minutes\nNo need to modify the code\n2025.6.19\n\nVideo Generation | Support V2.1 model\n\nUpdate image2video kling-v2-1 model, supports STD mode and PRO mode\nUpdate image2video kling-v2-1-master model\nUpdate text"
      },
      {
        "pattern": "Parameters",
        "snippet": "ing method for multi-image elements is consistent with that of video character elements, and can be achieved by passing parameters through element_voice_id\n\n2026.03.18\n\nVideo Generation | Video Effects | New Feature\n\nLaunch of 6 new video effects: flash_drive, shush_my_dreams, french_elegance, finger_swipe, advent_of_flora, smooth_transition\n\nFor video effects details, refer to: Video Effects Center\n\n2026.03.11\n\nVideo Generation | 3.0 Omni supports intelligence shot type\n\nWhen the value of the shot_type parameter is set to intelligence, intelligent storyboarding can be achieved\n\nVideo Generation | Elaborate on some business logic descriptions\n\nWhen generating the start & end frames of a video using thekling-video-o1 model, referencing a element is not supported.\n\nCustomizing elements through video only supports the creation of realistic-style, humanoid element.\n\nIn the code for Create Element API, the format of the element_voice_id parameter is set to string.\n\nMulti-camera does not support the start & end"
      },
      {
        "pattern": "external_task_id",
        "snippet": "n\nIncludes create task, query task (single), and query task (list) interfaces\n\nVideo Generation | Other Updates\n\nAdded “external_task_id” field, allowing you to customize a task ID when creating a task, and query the video using this custom ID when needed\n💡\n\nPlease note that in order to maintain naming consistency, the original model field has been changed to model_name, so in the future, please use this field to specify the version of the model that needs to be called.\n\nAt the same time, we keep the behavior forward-compatible, if you continue to use the original model field, it will not have any impact on the interface call, there will not be any exception, which is equivalent to the default behavior when model_name is empty (i.e., call the V1 model).\n2024.10.30\n\nAdded the “Query Resource Package List and Remaining Quantity” interface for your convenience. See “Section VI: Account Information Query”.\n\n2024.10.25\n\nTo ensure information security, generated images/videos will be cleared after 30 days. Plea"
      },
      {
        "pattern": "model_name",
        "snippet": "inding the element, and when binding the element, you can only refer to the orientation of the person in the video.\nAdd model_name parameter to distinguish model versions, default kling-v2-6\nFor generating STD mode motion control videos, 0.9 units will be deducted per second; for generating PRO mode motion control videos, 1.2 units will be deducted per second.\n2026.02.27\n\nVideo Generation | Video Effects | New Feature\n\nLaunch of 1 new video effects: raid_check\nFor video effects details, refer to: Video Effects Center\n2026.02.25\n\nVideo Generation | 3.0 Omni and V3 model launched\n\nImage Generation | 3.0 Omni and V3 model launched\n\nGeneral | The elements features have been fully upgraded\n\nSupports the creation of elements through video, and when creating elements, it is possible to bind voice and use them to specify the voice during video generation.\nUpgrade the creation element to an asynchronous service to fulfill more element-related functions.\nThe new element service adopts a brand-new API (advanced-cust"
      }
    ],
    "notes": [
      "client correlation id supported",
      "reference-video style usage visible"
    ]
  }
}