POST /v2/video_generation 创建任务、GET /v2/query/video_generation/{task_id} 查询任务，GregAPI 以代理接口形式对外提供，两者都必须携带 Bearer Token。
1. 模型与能力
minimax-h3-768p-second、minimax-h3-2k-second、minimax-h3-extra-input-image、minimax-h3-max-480p-second、minimax-h3-max-768p-second 是 GregAPI 内部计费组件 SKU，不能作为 model 取值，也不是可配置的模型 allowlist 条目。
2. 接口
所有请求使用 GregAPI API Token：
3. 创建任务
请求体
content 中的 text 项提示词最多 7000 个 Unicode 字符，且不能设置 role。
创建示例
4. 内容与媒体规则
content 中媒体项按类型和数量受限：
image_url 未提供 role 时按 first_frame 处理。约束如下：
- 首/尾帧模式不能与任何参考素材混用；
- 仅提供
reference_audio时，必须同时提供reference_image或reference_video。
比例与模式
- 文生视频：没有媒体项时
ratio必填，且必须是具体比例，不能为adaptive。 - 首/尾帧：包含
first_frame或last_frame时使用adaptive。 - 参考素材：包含任一
reference_*项时，ratio可省略（默认adaptive），也可传adaptive或具体比例。
5. 媒体 locator 与大小限制
每个image_url.url、video_url.url、audio_url.url 只能使用以下 locator：
- 公网
https://URL。GregAPI 会对 URL 做 DNS fail-closed 和私网/回环地址拦截；不接受 HTTP、file:、ftp:、blob:、javascript:或协议相对 URL。 - 严格的
data:<mime>;base64,<payload>。metadata 必须恰为<mime>;base64，不能有空白字符，payload 必须是非空严格 Base64。 - authority-only 的
mm_file://<positive-int64>。只允许正十进制 int64 authority，不能包含用户信息、端口、路径、query 或 fragment。
公网 HTTPS URL 和
mm_file 引用不会由 GregAPI 拉取或在本地检查媒体内容，媒体格式等官方约束由上游校验。完整 JSON 请求体最大为 64 MiB；data URI 的 Base64 膨胀和其他字段也计入该限制，因此实际可用的解码后大小会低于单文件上限。
6. 查询任务
将创建响应的task_id（或 platform_id）放入路径参数：
task 对象，并在顶层附加 platform_id；base_resp 也可能出现。task 可包含 id、status、model、task_type、resolution、duration、created_at、updated_at、content.url、usage 和 error。status 与时间字段以上游实际返回为准。
7. 计费与说明
- 成功结果中的
task.content.url是上游签名 URL，会过期，具体有效期以该 URL 与上游返回为准；请在收到后及时使用，不要把完整签名 URL 写入日志或长期存储。 - 创建失败、任务失败或取消时的计费结果以 GregAPI 账户和实际任务结算记录为准。