Callbacks

Configuration

Pass callback_url when creating a task:

{
  "model": "<seedance-model-id>",
  "content": [{"type": "text", "text": "..."}],
  "callback_url": "https://example.com/tuiwo/callback"
}

Requirements

• Must be a public HTTPS URL.
• The platform applies SSRF checks; private and localhost addresses are rejected.
• Delivered only after the task reaches a terminal state.
• At least once, with retries for up to 24 hours.
• No inbound callback management API and no callback signing secret.

Payload

The callback body is the task object, with the same fields as the query API. Correlate with id / task_id and make your handler idempotent.

Notes

• The callback URL is stored with the task; changing it requires creating a new task.
• If a callback fails, task status is still available through the query API.