Skip to Content
goldflow.cc Docs
VideosMiniMax Video

MiniMax H3 原生视频生成

POST
/v2/video_generation

使用 MiniMax H3 的 content[] 多模态格式创建异步视频任务,支持文本、首尾帧和参考媒体。当前本站本路径提供 MiniMax-H3;请求正文 model 固定为 MiniMax-H3,渠道权限与计费模型为 minimax-h3。文本输入务必指定具体 ratio。

goldflow.cc 返回 task_ 开头的公开任务 ID;后续查询、删除、source_task_id 均使用该 ID及创建任务的同一 goldflow.cc 令牌,不能换成供应商 ID。官方文档中的 Highspeed、Lite 或原生 Max 并非本站本路径的已上线模型;Max/Turbo 请使用独立平台接口。

正文原样透传,显式 false/0 保留。回调由供应商发送,回调中的上游任务 ID不能替代网关公开 ID;本站未提供 mm_file://、MiniMax 文件 API 或任务列表代理。接口字段参考官方创建文档,本站支持范围以本说明为准。

Authorization

bearerAuth
headerAuthorizationBearer <API key>

使用 Authorization Bearer API Key 进行鉴权。

Request Body

application/json
  1. body
model*"MiniMax-H3"

原生正文固定值;路由与计费模型由调用的操作端点决定。

Value in"MiniMax-H3"
content*array<|||>

必须包含非空 text项。首/尾帧场景与 reference_image/reference_video/reference_audio场景不能混用。图片/视频/音频 URL必须公网可下载,具体素材规格由上游校验。

Items1 <= items
duration*integer

目标时长,整数秒。

Range4 <= value <= 15
resolution*string
Value in"768P""2K"
ratio?string

文生视频必须显式指定具体比例,不能为adaptive;图生视频按输入自适应;多模态参考可指定具体比例。

Value in"adaptive""21:9""16:9""4:3""1:1""3:4""9:16"
callback_url?string

上游回调地址;需按供应商回调验证契约实现。回调中的上游ID不能用于网关查询。

Formaturi
aigc_watermark?boolean

显式false会保留发送上游。

Defaultfalse
[key: string]?any

Response Body

任务已受理;保存 goldflow.cc 公开 task_id,按原生查询接口轮询。受理不代表生成完成。

application/json
  1. response
task_id*string
Match^task_.+
[key: string]?any
curl -X POST 'https://goldflow.cc/v2/video_generation' \  -H 'Content-Type: application/json' \  -d '{  "model": "MiniMax-H3",  "content": [    {      "type": "text",      "text": "一只红色陶瓷茶壶放在晨光中的木桌上,镜头平稳推近。"    }  ],  "resolution": "768P",  "duration": 4,  "ratio": "16:9",  "aigc_watermark": false}'
Example Response
{  "task_id": "task_H3_GENERATION_EXAMPLE"}