TEXT TO VIDEO

文生视频 API

使用 Seedance、Wan、HappyHorse、Grok Imagine、Kling 或 MiniMax 将文本提示词转化为视频片段，部分模型支持同步生成音频。请求采用异步方式：您将先获取任务，随后获取视频结果。

模型

以下所有模型均在 POST /v1/videos/generations 中使用 mode "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。

模型