Tilbakekallings-URL

​

Hvor du bruker det

• Tekst-til-video- og bilde-til-video-oppgaver
• Avatar- og videoeffektoppgaver
• Andre asynkrone Kling-ruter som eksponerer et valgfritt callback_url-felt

​

Leveringsatferd

• Kling sender POST til callback-endepunktet ditt hver gang oppgavestatus endres
• Vanlige statuser er submitted, processing, succeed og failed
• Payloaden kan inkludere task_result.images eller task_result.videos avhengig av oppgavetypen
• Hold manuell polling tilgjengelig for avstemming, retries eller håndtering av tapte webhooker

​

Integrasjonssjekkliste

• Bruk et HTTPS callback-endepunkt du kontrollerer
• Godta gjentatte statusoppdateringer for samme task id
• Behandle webhook-levering som asynkron og eventual consistent
• Lagre de endelige asset-URL-ene raskt hvis arbeidsflyten din trenger varig lagring

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