updateNotice

The parameters are consistent. When integrating, you only need to replace the request domain and API key with ours.

Asynchronous Task Callback Protocol

For asynchronous tasks (image generation / video generation), if a callback_url is set when creating a task, the server will proactively send a notification whenever the task status changes.

Callback Data Format

{
  "task_id": "string",           // Task ID, system-generated
  "task_status": "string",       // Task status
  "task_status_msg": "string",   // Task status message
  "created_at": 1722769557708,   // Task creation time (Unix timestamp, in ms)
  "updated_at": 1722769557708,   // Task last updated time (Unix timestamp, in ms)
  "task_result": {
    "images": [                  // Results for image-type tasks
      {
        "index": 0,             // Image index, 0–9
        "url": "string"         // URL of the generated image
      }
    ],
    "videos": [                 // Results for video-type tasks
      {
        "id": "string",         // Video ID, globally unique
        "url": "string",        // URL of the video
        "duration": "string"    // Total video duration, in seconds
      }
    ]
  }
}

Task Status Description

Possible enum values for task_status:

submitted: Submitted

processing: Processing

succeed: Succeeded

failed: Failed

Notes

When a task fails, task_status_msg will display the reason for the failure (e.g., triggered the platform's content moderation policy).

Example image URL: https://h1.inkwai.com/bs2/upload-ylab-stunt/1fa0ac67d8ce6cd55b50d68b967b3a59.png

Callback Protocol

For other parameters, please refer to the official documentation: https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice#

Asynchronous Task Callback Protocol#

Callback Data Format#

Task Status Description#

Notes#

For other parameters, please refer to the official documentation: https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice

Asynchronous Task Callback Protocol

Callback Data Format

Task Status Description

Notes