updateNotice

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

Asynchronous Task Callback Protocol

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

Callback Data Format

{
"task_id": "string", // Task ID, generated by the system
"task_status": "string", // Task status
"task_status_msg": "string", // Task status message
"created_at": 1722769557708, // Task creation time (Unix timestamp, unit: ms)
"updated_at": 1722769557708, // Task update time (Unix timestamp, unit: ms)
"task_result": {
"images": [ // Result of image-related tasks
{
"index": 0, // Image index, 0-9
"url": "string" // URL of the generated image
}
],
"videos": [ // Result of video-related tasks
{
"id": "string", // Video ID, globally unique
"url": "string", // URL of the video
"duration": "string" // Total duration of the video, unit: s
}
]
}
}

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 show the reason for failure (e.g., triggering platform content risk control, etc.)

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

Callback protocol

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#

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