Integration guide
Start with a minimal request, then incorporate authentication, request state, and error handling into your server's request layer.
Distinguish service URLs
| URL | Purpose |
|---|---|
| Platform website | Sign-in, key management, model selection, and usage |
| Documentation website | Integration guides and API reference |
| API service root | Model requests; provided by the platform |
Different protocols may use different path prefixes. The Seedance native path is /api/v3/contents/generations/tasks; do not add an extra /v1 prefix.
Handle asynchronous tasks
Save the returned id after submitting a task. Set a polling interval, a maximum attempt count, and an overall timeout. Stop polling immediately at a terminal state. Also stop local waiting when the page is left or the operation is cancelled.
Prevent duplicate submissions
A network timeout does not mean the server did not receive the request. Check existing task records before submitting again to avoid duplicate tasks and charges.
Handle errors
Keep the HTTP status and error response. Resolve authentication, parameter, and permission problems before considering retries. For rate limits and temporary service failures, use backoff with a maximum retry count.
Webhooks
The reviewed API definitions do not include Webhook configuration fields. Use task queries for now; do not assume callbacks are available.

