Seedance 2.0 Video API
Xenodia 経由で非同期 Bytedance Seedance 2.0 video task を作成し、標準 task API で polling する。
Xenodia の public Seedance 2.0 video generation には POST /v1/videos/generations を使います。
Video generation は task-only です。request を送信し、task ID を保存し、Task Retrieval で polling します。
Endpoint
POST https://api.xenodia.xyz/v1/videos/generationsPOST /v1/video/generations も compatibility alias として登録されています。新規 integration では plural /v1/videos/generations を優先してください。
Text-to-video request
{
"model": "seedance-2-fast",
"prompt": "A cinematic beach at sunset, gentle waves, palm trees, and orange sky.",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration": 5,
"generate_audio": false
}First and last frame request
{
"model": "seedance-2",
"prompt": "Animate a product reveal from the first frame into the final packaging frame.",
"first_frame_url": "https://example.com/first.png",
"last_frame_url": "https://example.com/last.png",
"resolution": "1080p",
"aspect_ratio": "16:9",
"duration": 8
}Multimodal reference request
{
"model": "seedance-2-fast",
"prompt": "Use the references to create a fast, polished launch video.",
"reference_image_urls": ["https://example.com/style.png"],
"reference_video_urls": ["https://example.com/motion.mp4"],
"reference_audio_urls": ["https://example.com/music.mp3"],
"resolution": "720p",
"aspect_ratio": "9:16",
"duration": 10,
"web_search": false,
"nsfw_checker": false
}Supported public models
| Model | Resolutions |
|---|---|
seedance-2 | 480p、720p、1080p |
seedance-2-fast | 480p、720p |
Input modes
| Mode | Fields |
|---|---|
| Text-to-video | prompt のみ。 |
| First frame image-to-video | first_frame_url。 |
| First and last frame image-to-video | first_frame_url と last_frame_url。 |
| Multimodal reference-to-video | reference_image_urls、reference_video_urls、reference_audio_urls のいずれか。 |
first_frame_url / last_frame_url は multimodal reference arrays と併用できません。Media reference には public URL または Xenodia asset://... ID を使います。
Parameters
| Field | Notes |
|---|---|
model | seedance-2 または seedance-2-fast。 |
prompt | 必須 prompt。3 から 20000 characters。 |
first_frame_url | optional first frame image URL または asset://... ID。 |
last_frame_url | optional last frame image URL または asset://... ID。first_frame_url が必要。 |
reference_image_urls | optional image URL / asset://... array。最大 9。 |
reference_video_urls | optional video URL / asset://... array。最大 3。存在すると with_video pricing tier。 |
reference_audio_urls | optional audio URL / asset://... array。最大 3。 |
return_last_frame | optional boolean。Deprecated compatibility parameter。 |
resolution | seedance-2 は 480p、720p、1080p、seedance-2-fast は 480p、720p のみ。default 720p。 |
aspect_ratio | 1:1、4:3、3:4、16:9、9:16、21:9、adaptive。 |
duration | 4 から 15 秒。default 5。per-second price tier に掛けられます。 |
generate_audio, web_search, nsfw_checker | optional switches。 |
callBackUrl | optional completion callback URL。Xenodia task polling も利用可能。 |
Pricing
Seedance 2.0 は token priced ではありません。Xenodia は生成秒数で課金します：
actual cost = per-second tier price * duration * channel marginTier は resolution と reference_video_urls の有無で選ばれます。seedance-2-fast には 1080p tier がありません。価格表示 UI の前に /v1/models を問い合わせてください。
Response
Xenodia media task envelope を返します：
{
"task_id": "task_123",
"object": "task",
"model": "seedance-2-fast",
"type": "video",
"state": "waiting",
"created_at": 1760000000,
"poll_url": "/v1/tasks/task_123",
"recommended_poll_interval_ms": 5000
}Polling 成功時、result.data[].url に generated video URL が入ります。よくある error status は 400、401、402、502 です。