MiniMax 视频生成
MiniMax 使用 OpenAI 兼容入口提交异步视频任务，以 JSON 为主，当前仅支持 模型。
http
POST /v1/videos任务提交成功返回 id，用 任务查询 轮询结果。请求体总大小不超过 64 MB，大文件请使用公网 URL，避免 Base64。
当前可用模型
生成场景（由请求参数自动判定）
| 场景 | 传参 | 宽高比 |
|---|---|---|
| 文生视频 | 仅 | 默认 ，不可为 |
| 图生视频 | 或 | 强制 |
| 多模态参考生视频 | / | 默认 |
图生视频与多模态参考生视频互斥，不可混用。
请求头
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 请求身份认证。使用 Bearer Token，示例： | |
| string | 是 | 请求内容类型，必须设置为 |
请求体
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 模型名称 | |
| string | 是 | 提示词，所有生成场景都需提供非空，单条最多 7000 字符 | |
| integer | 否 | 时长（秒），取值 4–15，默认 ；超出范围被网关自动钳制 | |
| string | 否 | 分辨率： / ，默认 | |
| string | 否 | 单张输入图片作为首帧；与 二选一，同时传以 image 优先 | |
| array<string> | 否 | 多张参考图（图生视频） | |
| / | string | 否 | 多模态参考素材（参考生视频） |
请求示例
bash
curl -X POST https://octopusx.ai/v1/videos \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"prompt": "一支花蕾在延时摄影中绽放",
"duration": 5,
"size": "2K"
}'响应示例
json
{
"id": "task_a1bxxxxxe5f6",
"task_id": "task_a1bxxxxxe5f6",
"object": "video",
"model": "MiniMax-H3",
"status": "queued",
"progress": 0,
"created_at": 1785125529
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
| string | 任务 ID，用于后续查询（网关公开 ID） | |
| string | 任务 ID 兼容旧接口（待废弃，值同 ），新接入请用 id | |
| string | 固定为 | |
| string | 任务使用的模型名称 | |
| string | 任务状态： / / / | |
| integer | 进度百分比 0–100 | |
| integer | 创建时间戳 |
其它格式与模式
官方格式（/v1/video/generations）
以多模态 数组创建任务（同 Seedance 官方格式的组织方式），查询用 GET /v1/video/generations/{task_id}。
再生成（/v1/videos/{video_id}/remix）
把已生成的 768P 视频再生成 2K。按任务 ID 方式：路径参数 传源任务 ID（推荐，无需 prompt）；按源视频方式：Body 传 （须附全部原输入且 与生成时完全一致）。仅支持 MiniMax-H3 768P 输出规格的源视频，源任务须在 7 天查询窗口内。