コールバックプロトコル

その他のパラメータ

公式ドキュメント https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice を参照してください。パラメータは同一です。連携時はリクエストドメインと API キーを当社のものに変更するだけで構いません。

非同期タスクのコールバックプロトコル

非同期タスク（画像生成／動画生成）で、タスク作成時に callback_url を設定した場合、タスク状態が変わるとサーバーから能動的に通知が送られます。

コールバックデータ形式

{
  "task_id": "string",           // 任务ID，系统生成
  "task_status": "string",       // 任务状态
  "task_status_msg": "string",   // 任务状态信息
  "created_at": 1722769557708,   // 任务创建时间（Unix时间戳，单位ms）
  "updated_at": 1722769557708,   // 任务更新时间（Unix时间戳，单位ms）
  "task_result": {
    "images": [                  // 图片类任务的结果
      {
        "index": 0,             // 图片编号，0-9
        "url": "string"         // 生成图片的URL
      }
    ],
    "videos": [                 // 视频类任务的结果
      {
        "id": "string",         // 视频ID，全局唯一
        "url": "string",        // 视频的URL
        "duration": "string"    // 视频总时长，单位s
      }
    ]
  }
}

タスク状態の説明

task_status の取りうる値：

• submitted：送信済み
• processing：処理中
• succeed：成功
• failed：失敗

注意事項

• タスクが失敗した場合、task_status_msg に失敗理由が表示されます（プラットフォームのコンテンツモデレーションなど）
• 画像 URL の例：https://h1.inkwai.com/bs2/upload-ylab-stunt/1fa0ac67d8ce6cd55b50d68b967b3a59.png