Skip to content

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 ​

json
{
  "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