Kling callback-URLs verwenden

Verwenden Sie callback_url bei asynchronen Kling-Aufgaben, wenn Sie Push-Zustellung statt reinem Polling möchten.

Wo es verwendet wird

Text-zu-Video- und Bild-zu-Video-Aufgaben
Avatar- und Videoeffekt-Aufgaben
Andere asynchrone Kling-Routen, die ein optionales Feld callback_url bereitstellen

Zustellungsverhalten

Kling sendet an Ihren Callback-Endpunkt, sobald sich der Aufgabenstatus ändert
Gängige Status sind submitted, processing, succeed und failed
Die Payload kann je nach Aufgabentyp task_result.images oder task_result.videos enthalten
Halten Sie manuelles Polling für Abgleich, Wiederholungsversuche oder die Behandlung 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 schließlich konsistent
Speichern Sie die finalen Asset-URLs schnell, 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"
      }
    ]
  }
}