How to Use Seedance: Three Real Paths (and the Gotcha That Breaks Most First Attempts)

Description and use

Step‑by‑step guide for using Seedance: three paths – web console, official API with region‑specific model IDs, and a gateway, covering async job handling and URL expiration.

Problem

Users need a clear, up‑to‑date guide for generating videos with Seedance, avoiding confusion from outdated UI‑only tutorials and platform‑specific quirks.

Outcome

Users can reliably generate Seedance videos via the most suitable path, with clear steps for API usage, model‑ID handling, and prompt download to avoid URL expiration.

Workflow

• 1. Choose a path based on use case (single video, programmatic generation, or integrated gateway).
• 2. For Dreamina: create account, upload reference, generate, download (no API key).
• 3. For official API: register on Volcengine Ark or BytePlus ModelArk, obtain API key, purchase credits.
• 4. Confirm correct model ID prefix (doubao‑ for Volcengine, dreamina‑ for BytePlus).
• 5. Submit async generation task via POST to /contents/generations/tasks with model, content, duration, ratio, generate_audio.
• 6. Poll status endpoint until status is "succeeded" or "failed".
• 7. On success, retrieve video_url and download promptly (URL expires ~24h).
• 8. Handle errors and timeouts appropriately.
• 9. For gateway: use a single key to access Seedance and other models, simplifying billing and account management.

Evidence

The model IDs differ depending on which platform you're calling through. Volcengine Ark uses IDs like doubao-seedance-2-0-260128 for standard and a -fast variant for quicker, cheaper generation; BytePlus ModelArk uses dreamina-seedance-2-0-260128 and its own -fast variant instead.

Source

The generated video's URL expires — commonly documented around 24 hours — so download or move it to your own storage promptly rather than treating the returned URL as a permanent link.

Source