TEXT TO VIDEO

文字轉影片 API

使用 Seedance、Wan、HappyHorse、Grok Imagine、Kling 或 MiniMax 將文字提示詞轉換為影片片段，其中數個模型還支援音效生成。請求採非同步方式處理：先取得任務，完成後再取得影片。

模型

下方所有模型皆支援在 POST /v1/videos/generations 中使用 "text_to_video" 模式。價格為預設路由下所列解析度的每秒影片費用；Seedance 價格為根據其 token 計費方式推算的預估值。

模型與 API 模型 ID	選項	official-cheap 價格（預設）
Seedance 2.5`bytedance/seedance-2.5`	尺寸：480p, 720p, 1080p4–30 秒片段	720p 每秒 $0.213official：$0.231
Seedance 2.0`bytedance/seedance-2.0`	尺寸：480p, 720p, 1080p, 4K4–15 秒片段	720p 每秒 $0.139official：$0.151
Seedance 2.0 Fast`bytedance/seedance-2.0-fast`	尺寸：480p, 720p4–15 秒片段	720p 每秒 $0.111official：$0.121
Seedance 2.0 Mini`bytedance/seedance-2.0-mini`	尺寸：480p, 720p4–15 秒片段	720p 每秒 $0.07official：$0.076
Wan 3.0`alibaba/wan-3.0`	尺寸：480p, 720p, 1080p2–15 秒片段	720p 每秒 $0.083official：$0.092
Wan 3.0 Prime`alibaba/wan-3.0-prime`	尺寸：480p, 720p, 1080p2–15 秒片段	720p 每秒 $0.125official：$0.138
HappyHorse 1.1`alibaba/happyhorse-1.1`	尺寸：480p, 720p, 1080p3–15 秒片段	720p 每秒 $0.125official：$0.138
HappyHorse 1.0`alibaba/happyhorse-1.0`	尺寸：720p, 1080p3–15 秒片段	720p 每秒 $0.125official：$0.138
Grok Imagine Video 1.5`xai/grok-imagine-video-1.5`	尺寸：480p, 720p, 1080p1–15 秒片段	720p 每秒 $0.126official：$0.14
Grok Imagine Video 1.5 Lite`xai/grok-imagine-video-1.5-lite`	尺寸：480p, 720p, 1080p1–15 秒片段	720p 每秒 $0.027official：$0.03
Kling 4.0`kwaivgi/kling-4.0`	尺寸：720p, 1080p3–30 秒片段	720p 每秒 $0.138official：$0.154
MiniMax H3`minimax/h3`	尺寸：480p, 768p, 2K5–15 秒片段	768p 每秒 $0.072official：$0.08
MiniMax H3 Max`minimax/h3-max`	尺寸：480p, 768p5–15 秒片段	768p 每秒 $0.072official：$0.08
MiniMax H3 Max Turbo`minimax/h3-max-turbo`	尺寸：480p, 768p5–15 秒片段	768p 每秒 $0.036official：$0.04

快速入門

建立 API 金鑰
在主控台中建立金鑰，並將其儲存為 MLMUX_API_KEY 環境變數。
建立 API 金鑰
發送請求
範例會將 Seedance 2.0 (bytedance/seedance-2.0) 發送至 https://api.mlmux.com/v1/videos/generations。您可以將模型 ID 變更為上方表格中的任一模型。
讀取結果
回應為一個任務。每隔幾秒輪詢其 poll_url，直到 status 為 succeeded，即可下載影片，或設定 webhook 接收通知。
影片 API 參考文件

curl https://api.mlmux.com/v1/videos/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0",
  "route_mode": "official-cheap",
  "prompt": "A red fox walks through fresh snow at sunrise, slow tracking shot, cinematic light",
  "mode": "text_to_video",
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "generate_audio": true
}'

# The response is a task. Poll it until "status" is "succeeded", then read "video".
curl https://api.mlmux.com/v1/videos/generations/TASK_ID \
  -H "Authorization: Bearer $MLMUX_API_KEY"

常見問題

文字轉影片該選擇哪款模型？

Seedance 2.0 是正式環境應用的優質預設選項。Seedance 2.5 與 Wan 3.0 Prime 能呈現最具電影感的效果，Kling 4.0 可生成最長的片段（長達 30 秒），而 Grok Imagine Video 1.5 Lite 則是草稿製作與大量生成時成本最低的選擇。

文字轉影片 API 的費用是多少？

在預設的 official-cheap 路由下，每秒影片約從 $0.027 起（Grok Imagine Video 1.5 Lite）。Seedance 依片段消耗的 token 計費，其他模型則按秒計費；兩者費用皆取決於解析度與長度。

生成影片需要多長時間？

影片生成採非同步方式。請求會立即返回一個任務；您可以每隔幾秒對其 poll_url 進行輪詢，或在影片準備就緒時接收 webhook 通知。

失敗的請求會被計費嗎？是否有上限限制？

失敗的請求不會計費，預扣的點數將退回您的餘額。每個帳號最多可同時執行 60 個任務；如需提高上限，請寄信至 support@mlmux.com。

模型