seedance-2.5 API

使用準確的型號 ID seedance-2.5。模型欄位必須與此頁面完全相符。

範例輸出seedance-2.5POST /v1/videos5.1s

參數： duration=5resolution=1080pratio=16:9

提示詞： A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.

產生此樣本的請求

{
  "model": "seedance-2.5",
  "prompt": "A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

身份驗證與端點

將 Modelflare API 金鑰與 https://modelflare.dev/v1 結合使用。網關入口點是POST /v1/videos。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

創建任務

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false
  }'

投票及下載

儲存任務ID。輪詢 GET /v1/videos/{task_id} 並使用 GET /v1/videos/{task_id}/content 下載。結果 URL 可能會過期，因此請立即傳輸檔案。

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

請求備註

Seedance 將 content[] 用於文字、框架和參考媒體；單獨的Seedance資產管理合約是獨立記錄的。

注意

虛擬人像圖片請先上傳至 Seedance 素材庫，待狀態變為 Active 後，在 content[] 中引用 asset://<ID>。Modelflare 不提供真人認證。

請求參數

Seedance 使用一個非同步多模態包絡。將文字和媒體放入content[]；媒體角色選擇第一幀/最後一幀或參考工作流程。

場	必填	註釋
model	是	seedance-2.5
content[]	是	text、image_url、video_url 和 audio_url；使用role來識別媒體目的
resolution	否	480p / 720p / 1080p
ratio	否	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	否	-1 自動計時，或 4–30 秒
generate_audio	否	產生同步對話、效果與背景音頻
tools	否	僅在官方模型頁面支援的情況下使用web_search
watermark	否	是否添加浮水印
omni_reference_task_type	否	auto / reference / edit / extend;編輯和擴展施加更嚴格的比率/持續時間規則
output_format	否	mp4 / mov
return_last_frame	否	以影像形式傳回最終幀

輸入與輸出限制

此型號支援 480p、720p 和 1080p。使用 -1 自動計時或選擇 4–30 秒。一個請求最多可以組合 30 個影像、10 個視訊和 10 個音訊剪輯。普通參考產生接受明確的比率或adaptive；編輯、擴展和第一幀/最後一幀工作流程需要 ratio: "adaptive"，編輯需要 duration: -1。虛擬人像圖片必須先上傳至素材庫；Modelflare 不提供真人認證。

記錄的工作流程範例

Seedance 2.5 根據媒體角色和任務類型對參考、編輯、擴充和框架引導的工作流程進行分類。這些範例在使用 Modelflare 的端點和模型 ID 的同時保留了官方合約。

多模態參考

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "reference",
    "content": [
      {"type":"text","text":"@image1 performs the movement from @video1, paced to @audio1"},
      {"type":"image_url","image_url":{"url":"https://example.com/character.jpg"},"role":"reference_image"},
      {"type":"video_url","video_url":{"url":"https://example.com/motion.mp4"},"role":"reference_video"},
      {"type":"audio_url","audio_url":{"url":"https://example.com/music.mp3"},"role":"reference_audio"}
    ],
    "ratio": "16:9", "duration": 15, "output_format": "mp4"
  }'

影片編輯

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"Remove the background pedestrians but preserve the main subject"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "ratio": "adaptive", "duration": -1, "output_format": "mov"
  }'

視訊擴展

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "extend",
    "content": [{"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}],
    "ratio": "adaptive", "duration": 11, "output_format": "mov"
  }'

第一幀與最後一幀

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "content": [
      {"type":"text","text":"The subject smiles while the camera makes a smooth orbit"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "ratio": "adaptive", "duration": -1, "return_last_frame": true
  }'

錯誤與失敗的任務

無效模型參數傳回帶有請求 ID 的 4xx。非同步任務建立成功後也可能進入失敗；使用輪詢回應中的 error_code 和 error_message 作為最終任務原因。不要使用不同的 JSON 形狀重試相同的請求。

支援範圍

此頁面涵蓋 Modelflare 模型產生和編輯呼叫。搜尋或地圖豐富、語音管理和元素庫管理是此公共模型呼叫表面之外的資源 API，並且不是必需的請求欄位。

定價與計費

此模型使用基於令牌的計費。請參閱 型號定價頁面 ，以了解當前客戶價格、參考標價和完整規格。

注意

此頁面記錄了 Modelflare 的公共介面；此處顯示的欄位和限制是目前合約。

變體

型號 ID	差異
seedance-2.5	本頁記錄的模型。