MiniMax · 视频

首尾帧视频NEW

📌 这是什么：给定首帧（可再加尾帧），生成从首帧出发、过渡到尾帧的视频：成片第一帧≈first_image、最后一帧≈last_image，中间为平滑过渡。

💡 什么时候用：想精确控制视频开头画面时用；再给尾帧即可控制结尾并生成两帧之间的过渡。⚠ 首尾帧模式与 image_urls / audio_urls / reference_videos 互斥——不能再传普通参考图、音频或参考视频；时长最长 10 秒。

🔗 响应格式：查询响应为 OpenAI 视频任务格式：顶层字段结构（不套 {code,msg,data} 壳），状态小写 queued / running / success / failed，成功返回 video_url，失败返回 {"error":{"code","message"}}；video_url 为我方 CDN 直链，可直接下载/播放。

接口地址

用途	方法	路径
提交任务	POST	/v1/videos
查询结果	GET	/v1/videos/{taskId}

⏱ 建议轮询时间：建议每 5 秒轮询一次 GET /v1/videos/{taskId}，直到 status = success / failed。

请求参数

参数	类型	必填	说明
model	string	—	固定 minimax-h3
workflow_id	string	—	工作流，本页固定 fl2v（不传时按素材推断：给 first_image→fl2v、给 image_urls→multi-reference、都没有→text-to-video；CF 超分 / 4 图 / 灵活多参考 / MJ 无法推断，需显式指定）
prompt	string	必填	必填，文本描述（新引擎任何情况下都要求 prompt——图生视频/首尾帧也必须给，如「镜头缓缓推进，光线柔和」）
first_image	string	必填	首帧关键帧图 URL（必填，别名 first_frame_image）；只给首帧＝指定起始画面，尾帧由模型发挥
last_image	string	—	尾帧关键帧图 URL（可选，别名 last_frame_image）；须与 first_image 一起用，只传尾帧返回 invalid_request
ratio	string	—	画面比例，8 选 1：16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9，默认 16:9（比例 × 清晰度档位共同决定输出分辨率，见介绍页尺寸对照）
resolution	string	—	清晰度档位（大小写不敏感）：480P / 768P / 1080P，默认 1080P；单价随档位分档，见定价页
duration	integer	—	时长（秒）整数 4~10，默认 4（别名 seconds）
prompt_enhance	boolean	—	提示词增强（可选，布尔）；不传用默认（开启）

请求示例

curl -X POST https://api.cqtai.com/v1/videos \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "minimax-h3",
    "workflow_id": "fl2v",
    "prompt": "smooth transition between the two frames",
    "first_image": "https://cdn.novapi.ai/your/first.png",
    "last_image": "https://cdn.novapi.ai/your/last.png",
    "ratio": "16:9",
    "resolution": "1080P",
    "duration": 6
  }'
# -> 创建响应: { "id":"<task_id>", "task_id":"<task_id>", "object":"video", "model":"minimax-h3", "status":"PROCESSING", "progress":0 }

响应示例

{
  "id": "b976d0f8c1ed4c1c8ef006ea22161bcc",
  "task_id": "b976d0f8c1ed4c1c8ef006ea22161bcc",
  "object": "video",
  "model": "minimax-h3",
  "status": "success",
  "progress": 100,
  "video_url": "https://cdn.novapi.ai/minimax/1786516943631_d6ddaeaa68a4464f9e16938f16b9534b.mp4"
}

响应字段说明

字段	类型	说明
id	string	任务 ID（不透明串），与 task_id 相同，用于 GET /v1/videos/{task_id} 轮询
task_id	string	任务 ID（不透明串），提交响应返回、用于轮询查询
object	string	对象类型，固定 "video"
model	string	模型名，固定 "minimax-h3"
status	string	任务状态（小写）：queued 已排队 / running 生成中 / success 成功 / failed 失败
progress	number	进度 0~100
video_url	string	生成结果视频地址（我方 CDN 直链），status = success 时返回
error	object	失败信息 {"code","message"}，status = failed 时返回