Callback-URL

​

Wo sie verwendet wird

• Text-to-Video- und Image-to-Video-Tasks
• Avatar- und Video-Effects-Tasks
• Andere asynchrone Kling-Routen, die ein optionales Feld callback_url bereitstellen

​

Zustellungsverhalten

• Kling sendet an Ihren Callback-Endpunkt, sobald sich der Task-Status ändert
• Häufige Statuswerte sind submitted, processing, succeed und failed
• Die Payload kann je nach Task-Typ task_result.images oder task_result.videos enthalten
• Halten Sie manuelles Polling für Abgleich, Wiederholungen oder die Verarbeitung verpasster Webhooks verfügbar

​

Integrations-Checkliste

• Verwenden Sie einen HTTPS-Callback-Endpunkt, den Sie kontrollieren
• Akzeptieren Sie wiederholte Statusaktualisierungen für dieselbe Task-ID
• Behandeln Sie die Webhook-Zustellung als asynchron und eventually consistent
• Speichern Sie die finalen Asset-URLs zügig, wenn Ihr Workflow dauerhafte Speicherung benötigt

{
  "task_id": "string",
  "task_status": "string",
  "task_status_msg": "string",
  "created_at": 1722769557708,
  "updated_at": 1722769557708,
  "task_result": {
    "images": [
      {
        "index": 0,
        "url": "https://example.com/generated-image.png"
      }
    ],
    "videos": [
      {
        "id": "string",
        "url": "https://example.com/generated-video.mp4",
        "duration": "5"
      }
    ]
  }
}