updateNotice

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

Asynchronous Task Callback Protocol

For asynchronous tasks (image generation/video generation), if callback_url is set when creating a task, the server will actively send notifications when 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, unit: ms)
  "updated_at": 1722769557708,   // Task update time (Unix timestamp, unit: ms)
  "task_result": {
    "images": [                  // Result for image-type tasks
      {
        "index": 0,             // Image index, 0-9
        "url": "string"         // URL of the generated image
      }
    ],
    "videos": [                 // Result for video-type tasks
      {
        "id": "string",         // Video ID, globally unique
        "url": "string",        // Video URL
        "duration": "string"    // Video total duration, unit: s
      }
    ]
  }
}

Task Status Description

Possible enumeration values for task_status:

submitted: Submitted

processing: Processing

succeed: Succeeded

failed: Failed

Notes

When a task fails, task_status_msg will display the failure reason (such as triggering the platform's content moderation)

Image URL example: 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