创建视频生成请求

通过输入提示词生成视频。该接口返回用户当前请求的 requestId，用户需要通过轮询状态接口获取具体的视频链接。生成结果有效期为 10 分钟，请及时获取视频链接。Wan2.2 系列模型将于 2026-11-10 下线，本文档已按 MiniMax-H3 更新，详见更新公告。

Authorization

AuthorizationBearer <token>required

添加 Header 'Authorization: Bearer {账户 API Key}' 进行鉴权

In: header

Header Parameters

X-Trace-Idstring

请求追踪 ID。可自定义传入用于标记本次请求；若不传入，平台将自动生成。排查问题时，提供该值或响应头中的 x-siliconcloud-trace-id 均可。

traceparentstring

W3C Trace Context 标准追踪头。传入时，平台取其中的 trace-id 作为本次请求的追踪标识。

Request Body

modelstringrequired

对应的模型名称。为更好地提升服务质量，我们会对本服务提供的模型进行定期变更，包括但不限于模型上下线和模型服务能力的调整。在可行的情况下，我们会通过公告或消息推送等适当方式通知您此类变更。完整可用模型列表请查看视频生成模型。

Value in"MiniMaxAI/MiniMax-H3"

Example"MiniMaxAI/MiniMax-H3"

promptstringrequired

用于生成视频描述的文本提示词。

durationinteger

生成视频的时长，单位为秒。可选值范围为 5 到 15，默认值为 5。视频按请求的时长计费，请求成功即按该值计费，生成失败将退还相应费用。

Default5

Range5 <= value <= 15

Example5

resolutionstring

生成视频的分辨率。可选值：480p、768p，默认值为 768p。

Default"768p"

Value in"480p" | "768p"

ratiostring

生成视频的画面比例。可选值：1:1、3:4、4:3、9:16、16:9、21:9，默认值为 16:9。传入参考图片时，将按图片比例缩放到 resolution 指定的分辨率。

Default"16:9"

Value in"1:1" | "3:4" | "4:3" | "9:16" | "16:9" | "21:9"

imagesarray<object>

参考图片列表，用于首帧生视频、尾帧生视频、首尾帧生视频。可以不传或传入空数组；传入非空数组时，每个元素必须同时提供 url 和 role。

seedinteger

随机数生成器的种子值。

Response Headers

x-siliconcloud-trace-idstring

请求追踪 ID。本次请求的唯一追踪标识，便于日志查询和问题排查；未传入 X-Trace-Id 时由平台自动生成，传入时以该字段原样返回。排查问题时，提供任一 trace ID 即可。

Response Body

模型响应。

TypeScript Definitions

Use the response body type in TypeScript.

requestIdstring

调用状态接口时需要使用本次请求生成的 requestId。

curl --request POST \
  --url https://api.siliconflow.cn/v1/video/submit \
  --header 'Authorization: Bearer ***' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMaxAI/MiniMax-H3",
    "prompt": "一只猫在草地上奔跑",
    "duration": 5,
    "resolution": "768p",
    "ratio": "16:9"
  }'

import requests

url = "https://api.siliconflow.cn/v1/video/submit"
payload = {
    "model": "MiniMaxAI/MiniMax-H3",
    "prompt": "画面从清晨的草地平滑过渡到黄昏",
    "duration": 5,
    "resolution": "768p",
    "ratio": "16:9",
    "images": [
        {"url": "https://example.com/first-frame.jpg", "role": "first_frame"},
        {"url": "https://example.com/last-frame.jpg", "role": "last_frame"}
    ]
}
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

{
  "requestId": "string"
}

{
  "code": 20012,
  "message": "string",
  "data": "string"
}

"Invalid token"

"Forbidden"

"404 page not found"

{
  "message": "Request was rejected due to rate limiting. If you want more, please contact contact@siliconflow.cn. Details:TPM limit reached.",
  "data": "string"
}

{
  "code": 50505,
  "message": "Model service overloaded. Please try again later.",
  "data": "string"
}

"string"