metaso/MiniMax-H3
统一异步任务式视频生成服务：创建任务返回 task_id，轮询查询任务状态，成功后返回转存永久 CDN 链接。底层 MiniMax-H3 / metaso / 豆包 Seedance / 万相 wan3.0-video 按权重自动路由。查询支持单任务 GET /v1/videos/{task_id} 与批量 POST /v1/videos/status_batch（1-20 个 task_ids，一次返回各任务状态，轮询更省请求）；对口型任务（/v1/videos/lip-sync）也共用这两个查询接口。
接口详情
POST
https://ai.codenews.cc/v1/videos/generations请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| prompt | string | 是 | - | 视频描述，最多 1500 字符（超出由网关截断） |
| model | string | 否 | - | 可强制指定底层模型：minimax/MiniMax-H3 / metaso/MiniMax-H3 / volcengine/doubao-seedance-2-5-pro / aliyun/wan3.0-video，不传则按权重随机路由 |
| resolution | string | 否 | - | 480P / 720P / 768P / 1080P / 2K，按引擎能力收敛，非法回退引擎默认值 |
| duration | number | 否 | 5 | 视频时长（秒，整数），按引擎范围 clamp |
| ratio | string | 否 | 16:9 | adaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16；文生视频默认 16:9，图生视频固定 adaptive |
| image | string | 否 | - | 首帧图：公网 URL 或 data:image/*;base64,... |
| last_image | string | 否 | - | 尾帧图（需与 image 配对） |
| seed | number | 否 | - | 随机种子，用于结果复现 |
代码示例
请将 $API_KEY 替换为您在控制台申请的真实 API Key。
响应示例
错误码
| 状态码 | 说明 |
|---|---|
| 401 | API Key 无效或缺失 |
| 400 | 参数错误，如缺 prompt / 不支持的模型 / last_image 未配 image |
| 400 | 余额不足，请充值 |
| 400 | 内容命中敏感词 |
| 404 | 任务不存在或不属于当前 apikey |