Video
Seedance 2.5 Flash
依據文字、首尾影格或多模態參考素材，產生 480p 或 720p、長度 4–30 秒的影片，或編輯一支來源影片。
Seedance 2.5 Flash 支援文字轉影片、首尾影格生成、參考生成及影片編輯。使用 Default 層級的 dreamina-seedance-2-5-flash。媒體須透過不需驗證憑證的公開 HTTP 或 HTTPS URL 傳送。儲存傳回的任務 ID，並查詢該任務以取得完成的影片。
請參閱 Playground 與即時價格、OpenAPI 規格及計價指南。
快速範例
這項請求會建立一支四秒影片。傳送前請查看目前價格；提交並成功生成會產生費用。
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "dreamina-seedance-2-5-flash",
"content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
"resolution": "480p",
"duration": 4,
"ratio": "16:9",
"generate_audio": false
}'參數
model 和 content 為必填欄位。其餘所有欄位均為選填。明確指定的 null 值及未知欄位會遭拒絕。
| 欄位 | 型別 | 預設值 | 限制 |
|---|---|---|---|
model | 字串 | 必填 | dreamina-seedance-2-5-flash |
content | 陣列 | 必填 | 至少包含一個非空文字項目；媒體項目必須指定角色。 |
resolution | 字串 | 720p | 480p 或 720p。 |
duration | 整數 | 5，編輯時為 -1 | 生成：4–30 秒。編輯：省略或使用 -1；輸出長度與來源相同。 |
ratio | 字串 | 16:9，首尾影格/編輯時為 adaptive | 文字/參考生成：16:9、9:16、1:1、4:3、3:4、21:9。首尾影格及編輯：僅限 adaptive。 |
generate_audio | 布林值 | true | 啟用或停用生成音訊；不影響費率。 |
omni_reference_task_type | 字串 | generate | generate 或 edit。編輯必須提供且僅提供一支影片。 |
content_filter | 布林值 | true | 僅接受 true；Playground 不需提供此控制項。 |
文件規定提示詞上限為 10,000 tokens。未指定公開的斷詞器，因此不可將字元數視為精確的 token 數。
內容與模式
文字使用 {"type":"text","text":"Describe the shot"}。圖片、影片與音訊使用巢狀 URL 及明確指定的角色：
{
"type": "image_url",
"image_url": {"url": "https://example.com/reference.jpg"},
"role": "reference_image"
}| 模式 | 內容 | 畫幅與長度 |
|---|---|---|
| 文字轉影片 | 僅文字 | 固定比例；4–30 秒。 |
| 首尾影格 | 文字加一張 first_frame 圖片，可選擇加入一張 last_frame 圖片 | adaptive；4–30 秒。提供尾影格時必須提供首影格。 |
| 參考生成 | 文字加 reference_image、reference_video 或 reference_audio 項目 | 固定比例；4–30 秒。最多 10 張圖片、5 支影片及 5 段音訊。 |
| 影片編輯 | 文字、恰好一支 reference_video，可選擇加入參考圖片/音訊；任務類型為 edit | adaptive；省略長度或使用 -1。 |
影片項目使用 type: "video_url"、video_url: {"url": "..."}、role: "reference_video"；音訊項目以相同結構使用 audio_url 及 reference_audio。首尾影格無法與參考媒體混用。此整合不提供 Draft、Extend、1080p、浮水印、種子及尾影格輸出控制項。不提供回呼。
媒體限制
| 媒體 | 格式 | 大小與長度 |
|---|---|---|
| 圖片 | JPEG, PNG, WebP | 上限 30 MB；每邊 300–6,000 px；寬高比 0.4–2.5。 |
| 影片 | MP4, MOV | 上限 200 MB；24–60 FPS；每邊 300–6,000 px；比例 0.4–2.5；409,600–8,295,044 像素。參考影片：每支 2–30 秒，合計最多 30 秒。編輯來源：4–30 秒。 |
| 音訊 | WAV, MP3 | 上限 15 MB；每段 2–30 秒，合計最多 30 秒。 |
提交前檔案必須可讀取。影片長度依媒體實測，以計算費用。請使用穩定的公開 URL。
任務回應與輪詢
建立任務會傳回 id、model、status 及 created_at。查詢同一任務，直到完成：
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"狀態為 processing、completed 或 failed。成功時讀取 output.video_url，以取得已儲存的影片。失敗時讀取 error.code 及 error.message。公開回應不包含費用。輪詢逾時不代表生成失敗：保留任務 ID 並再次查詢，不要另行提交生成。
計費
即時費率取決於解析度及是否提供影片。沒有影片輸入時，計費秒數等於輸出長度。有參考影片時，計費秒數等於輸出長度，加上輸出長度與向上取整後的輸入總長度兩者中的較大值。編輯以向上取整後的來源長度的兩倍計費。音訊已包含在內。失敗的請求不收費。
例如，五秒輸出搭配三秒參考影片，以十秒計費。編輯一支十秒來源影片，以二十秒計費。將計費秒數乘以適用的即時費率。