Skip to content
Reading settings
Getting started

Integration guide ​

Start with a minimal request, then incorporate authentication, request state, and error handling into your server's request layer.

Distinguish service URLs ​

URLPurpose
Platform websiteSign-in, key management, model selection, and usage
Documentation websiteIntegration guides and API reference
API service rootModel 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.