SeeDance 視頻生成

通過 TENSORAXIS 調用火山方舟 Doubao Seedance 系列：文生視頻、圖生視頻、首尾幀與視頻參考/續寫，以及 metadata 高級參數與計費說明。

SeeDance 是火山方舟（Volcengine Ark）Doubao Seedance 系列視頻模型在 TENSORAXIS 上的接入，渠道 doubao-video。和所有視頻模型一樣，它是異步任務：先提交任務取得 task_id，再輪詢任務狀態，完成後讀取視頻地址。提交與查詢的通用流程見視頻生成總覽，本頁只講 SeeDance 特有的能力與參數。

請使用本站入口字段 prompt、images 和 metadata，由 TENSORAXIS 轉換為火山方舟內容生成任務格式。不要把火山官方示例中的頂層 content[] 請求體直接發給 /v1/video/generations，否則會因缺少 prompt 返回 400 prompt is required。

模型與能力矩陣

模型	文生視頻	圖生視頻（首幀）	首尾幀	多模態參考（圖/視頻/音頻）	原生音頻
`doubao-seedance-1-0-lite-t2v`	✅	—	—	—	—
`doubao-seedance-1-0-lite-i2v`	—	✅	—	—	—
`doubao-seedance-1-0-pro-250528`	✅	✅	—	—	—
`doubao-seedance-1-5-pro-251215`	✅	✅	—	—	—
`doubao-seedance-2-0-260128`	✅	✅	✅	✅	✅
`doubao-seedance-2-0-fast-260128`	✅	✅	✅	✅	✅

2-0-fast 與 2-0 能力一致，主打更快出圖。能力支持以上游模型實際返回為準。

本站入口字段

POST /v1/video/generations

字段	類型	必填	說明
`model`	string	是	SeeDance 模型名，見上表
`prompt`	string	是	視頻提示詞；為空返回 `400 prompt is required`
`images`	string[]	否	參考圖 URL，用於圖生視頻（首幀）；多張參考圖也走這裡
`image`	string	否	單張參考圖 URL；`images` 為空時服務端會兼容轉換為 `images`
`seconds`	string	否	時長（秒）；正整數會轉成上游 `duration`，等價於 `metadata.duration`
`metadata`	object	否	SeeDance 高級參數，見下方 metadata 高級參數

文生視頻

僅提供 prompt，可在 metadata 中補充分辨率、時長、畫面比例等參數。

curl https://api.tensoraxis.ai/v1/video/generations \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "戴帽子的老爺爺微笑往前走，背景是秋天的街道",
    "metadata": {
      "resolution": "1080p",
      "ratio": "16:9",
      "duration": 5
    }
  }'

圖生視頻

首幀圖生

通過 images 傳入參考圖，作為視頻首幀；其餘參數同文生視頻。

curl https://api.tensoraxis.ai/v1/video/generations \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-0-lite-i2v",
    "prompt": "鏡頭緩慢拉近，人物微笑",
    "images": ["https://example.com/first-frame.jpg"],
    "metadata": {
      "resolution": "1080p",
      "duration": 5
    }
  }'

首尾幀（Seedance 2.0）

首尾幀需要用 metadata.content 顯式給每張圖標註 role（first_frame / last_frame），它會覆蓋由 images 生成的內容列表。結構見 metadata.content 結構。

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "從清晨到日落的延時變化",
  "metadata": {
    "resolution": "1080p",
    "duration": 5,
    "content": [
      { "type": "image_url", "image_url": { "url": "https://example.com/start.jpg" }, "role": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/end.jpg" }, "role": "last_frame" }
    ]
  }
}

視頻參考 / 續寫（等價「視頻編輯」）

SeeDance 後端沒有獨立的逐幀視頻編輯端點。Seedance 2.0 的「視頻多模態參考」能力允許把一段視頻作為輸入參考/續寫來源——通過 metadata.content 傳入帶 video_url 的條目即可。

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "延續這段視頻的運動，鏡頭繼續向右平移",
  "metadata": {
    "resolution": "1080p",
    "content": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }
}

當請求帶視頻輸入時，TENSORAXIS 會按真實媒體內容（而非 metadata 聲明）判定為「視頻輸入」類型並歸入更優惠的計費檔，見計費說明。如果你需要的是逐幀式視頻編輯（替換/重繪指定片段），請改用 HappyHorse 視頻編輯（happyhorse-1.0-video-edit）。

metadata 高級參數

metadata 下的字段會映射為火山方舟任務的頂層字段。下表「取值範圍 / 默認值」來自火山方舟官方說明，以上游對應模型實際返回為準；TENSORAXIS 只負責接收並轉發這些字段。

字段	轉發為	類型	取值範圍 / 默認	說明
`resolution`	`resolution`	string	`480p` / `720p` / `1080p` / `2k`，默認 `1080p`	輸出分辨率
`ratio`	`ratio`	string	`16:9` / `9:16` / `4:3` / `3:4` / `21:9` / `1:1` / `adaptive`	畫面比例
`duration`	`duration`	integer	`4`–`15`，默認 `5`	視頻時長（秒）；與頂層 `seconds` 等價
`frames`	`frames`	integer	由模型決定	總幀數（與幀率/時長相關）
`seed`	`seed`	integer	隨機種子	固定隨機性以復現結果
`camera_fixed`	`camera_fixed`	boolean	默認 `false`	是否固定鏡頭
`watermark`	`watermark`	boolean	默認 `false`	是否添加水印
`generate_audio`	`generate_audio`	boolean	默認 `false`	是否生成原生音頻（Seedance 2.0）
`return_last_frame`	`return_last_frame`	boolean	默認 `false`	是否返回末幀圖
`draft`	`draft`	boolean	默認 `false`	草稿/預覽模式
`service_tier`	`service_tier`	string	由模型決定	服務等級
`execution_expires_after`	`execution_expires_after`	integer	由模型決定	任務過期時間（秒）
`callback_url`	`callback_url`	string	—	任務完成回調地址
`tools`	`tools`	array	—	工具配置（如聯網搜索）
`content`	`content`	array	—	高級內容數組，見下節

注意事項：

metadata.model 會被移除，不能用它覆蓋計費模型。
未映射到上述字段的 metadata 鍵通常不會轉發給上游。
同時傳 seconds 與 metadata.duration 時，以 metadata.duration 為準。

metadata.content 結構

metadata.content 是高級內容數組，用於首尾幀、視頻參考、音頻參考等場景。一旦提供，它會覆蓋由 images 生成的內容列表（其中 type: text 的條目會被忽略，正文以 prompt 為準）。

條目類型	字段	官方約束（以上游為準）
`image_url`	`image_url.url`、可選 `role`	圖片 ≤30MB，≤9 張；`role` 用於首尾幀
`video_url`	`video_url.url`	視頻 2–15s，≤3 段
`audio_url`	`audio_url.url`	音頻 ≤15MB，≤3 段
`text`	`text`	會被忽略，正文以頂層 `prompt` 為準

計費說明

SeeDance 按 token 計費，分辨率已體現在 token 數量中，不另收分辨率係數。

普通生成（文生 / 圖生）歸 generate 檔。
帶視頻輸入（視頻參考/續寫）按真實媒體內容判定，歸入更優惠的 video_input 折扣檔（單價低於普通生成）。

具體單價以控制台「視頻計價」配置與定價頁為準；運營可按最新官方價覆蓋默認值。

任務查詢

提交、輪詢、狀態碼、OpenAI/Sora 兼容查詢路徑等通用流程，見視頻生成總覽。

On this page