Protocole de callback

Autres paramètres

Voir la documentation officielle : https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice. Les paramètres sont identiques ; lors de l’intégration, il suffit de remplacer le domaine de requête et la clé API par les nôtres.

Protocole de callback pour les tâches asynchrones

Pour les tâches asynchrones (génération d’images / de vidéos), si callback_url est défini à la création de la tâche, le serveur envoie une notification activement lorsque le statut de la tâche change.

Format des données de callback

{
  "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
      }
    ]
  }
}

Statuts de tâche

Valeurs possibles de task_status :

• submitted : soumis
• processing : en cours
• succeed : réussi
• failed : échec

Remarques

• En cas d’échec, task_status_msg affiche la raison (par ex. déclenchement de la modération de contenu de la plateforme)
• Exemple d’URL d’image : https://h1.inkwai.com/bs2/upload-ylab-stunt/1fa0ac67d8ce6cd55b50d68b967b3a59.png