视频接口总览

通过同一组本站接口完成视频的 提交 → 查询 → 下载。核对日期为 2026-10-29。不同型号的时长、画面比例、参考素材和计费单位不同，请先按下表选型号，再使用对应章节的请求体。

当前可选型号与费用单位

下表为当前公开目录快照。新建令牌后先执行 GET /v1/models，确认自己的分组和模型权限；公开目录中的模型不代表任意 Key 都能调用。表中价格是 ¤ 站内额度，是核对时所列分组的报价，不是永久价格承诺。

请求中的完整 model	分组	规格摘要	报价 / 计费单位	详细说明
`dreamina-seedance-2-0-mini-260615`	视频分组	480p / 720p，4–15 秒；图片、视频、音频参考	无参考视频 12.65；有参考视频 7.7 / 百万视频 Token	Seedance Mini/Fast
`dreamina-seedance-2-0-fast-260128`	视频分组	480p / 720p，4–15 秒；图片、视频、音频参考	无参考视频 26.455；有参考视频 15.73 / 百万视频 Token	Seedance Mini/Fast
`SD-2.0-MZ1`	seedance低价渠道，质量自测	固定 720p，5–15 秒；图片和音频参考	0.16 / 请求的输出秒数	SD 按秒视频
`MiniMax-H3`	视频分组	固定 768P，1–15 秒；关键帧及多模态参考	0.06 / 请求的输出秒数	MiniMax-H3
`grok-imagine-video-6s`	视频分组	固定 6 秒 / 720p；横屏或竖屏	0.08 / 次	Grok 视频
`grok-imagine-video-1.5-6s`	视频分组	固定 6 秒 / 720p；横屏或竖屏	0.10 / 次	Grok 视频
`grok-video-1.5`	default、视频分组	720p；按章节选择离散时长	0.85 / 次	Grok 视频

之前文档中的 dreamina-seedance-2-0-260128、dreamina-seedance-2-5-260628 已不在当前新建任务目录中。不要继续复制旧的 2.0/2.5 Token 请求。已有任务仍应保存原 ID 查询；不要用新型号重新提交来“恢复”旧任务。

按需求选择

需要视频参考、混合音频参考，或希望选择 480p / 720p：查看 Mini/Fast。
希望按明确的输出秒数估算费用：查看 SD 或 MiniMax-H3；两者的素材格式与声音选项不同。
希望使用固定 6 秒短片：选择名称带 -6s 的 Grok 型号。
已接入 grok-video-1.5：沿用其专属参数；不要把 -6s 型号的限制或参考图写法直接套过来。

模型名称中的 Fast、Mini、版本数字描述型号，不是生成时延、画质或可用性的保证。开始批量任务前，应以自己的真实素材验证目标规格。

统一接口地图

方法与路径	用途	成功后的处理
`GET /v1/models`	检查当前 Key 的模型权限	从 `data[].id` 取完整模型名
`POST /v1/videos`	创建一个视频任务	保存返回的本站 `id`，开始查询
`GET /v1/videos/{task_id}`	查询任务状态	处理 queued、in_progress、completed、failed
`GET /v1/videos/{task_id}/content`	下载完成视频	以二进制保存；检查 HTTP 状态与文件内容
`HEAD /v1/videos/{task_id}/content`	读取可用结果的响应头	可用于检查下载响应，不代替状态查询
`GET /v1/tasks/{task_id}/artifacts`	获取可用制品列表	适用于提供制品的任务；如请求并实际返回了末帧

所有请求均发送到 https://openpix.cc，携带 Authorization: Bearer <本站 API Key>。也支持 https://openpix.cc；同一任务保持同一入口和原 Key 最容易排查问题。

不需要把视频发送到 /v1/chat/completions。新接入优先使用本页统一接口，不需要复制任何专用路由前缀，也不需要填写额外的平台或服务商参数。

第一个视频请求

先在令牌管理创建具有“视频分组”和目标模型权限的 Key，并在服务端设置环境变量 MXB_API_KEY。下面创建一个固定 6 秒视频；执行 POST 会产生一次真实生成任务。

bash

curl --fail-with-body --max-time 120 \
  https://openpix.cc/v1/videos \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @grok-6s-text.json

下载 grok-6s-text.json 到命令执行目录，其完整内容如下：

json

{
  "model": "grok-imagine-video-6s",
  "prompt": "清晨湖面上的蓝色纸船缓缓漂动，柔和光线，镜头平稳推进",
  "seconds": "6",
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

成功受理的结构示例，ID 为虚构值：

json

{
  "id": "task_example_video_001",
  "object": "video",
  "model": "grok-imagine-video-6s",
  "status": "queued",
  "progress": 0,
  "created_at": 1793203200
}

HTTP 200 表示提交请求得到任务回执，不是视频已经生成完成。不要按图片接口的 data[0].url 解析这一步。

将真实 id 保存为环境变量 MXB_VIDEO_TASK_ID，每 5 秒左右查询同一任务：

bash

curl --fail-with-body --max-time 30 \
  "https://openpix.cc/v1/videos/$MXB_VIDEO_TASK_ID" \
  -H "Authorization: Bearer $MXB_API_KEY"

状态为 completed 后下载：

bash

curl --fail --max-time 180 \
  "https://openpix.cc/v1/videos/$MXB_VIDEO_TASK_ID/content" \
  -H "Authorization: Bearer $MXB_API_KEY" \
  --output result.mp4

没有使用 --retry 或自动重发 POST。下载或查询失败可以继续访问原任务，不必重新生成。完整程序见 Python、Node.js 与 PowerShell。

请求体通用规则

项目	要求
JSON 编码	UTF-8；`Content-Type: application/json`
型号	`model` 为完整公开 ID；区分大小写与后缀
时长	推荐使用 `seconds`；可用值按型号，不统一为任意正整数
宽高比	Seedance / SD / H3 用 `ratio`；Grok 推荐 `aspect_ratio`
分辨率	`resolution` 的合法值按型号；不要把共享价格字段当成能力清单
参考素材	按具体型号选择字段；`images`、`reference_images`、`metadata.content` 不可随意互换
布尔值	JSON 使用 `true` / `false`，不是字符串；型号不支持的开关应省略
多个别名	一个含义只填写一个字段；不要传冲突的 seconds/duration 或顶层/metadata 值
任务数量	每次提交对应一个任务；不要用未说明的 `n` 参数批量创建
分组	由 Key 配置决定；请求 JSON 中增加 group 不能切换价格分组

返回字段与完整生命周期

具体响应字段、失败状态、HEAD/Range 下载、末帧获取、超时、重试与账单核对见视频任务与下载。参考素材的 URL、文件上传、首尾帧与多图区别见视频参考素材。

本站没有在本手册承诺统一的任务取消、回调 webhook、POST 幂等、生成时延或永久媒体托管。不要将其他平台的功能默认视为本站所有型号都支持。

本次核对范围

型号、分组、价格和请求校验与 2026-10-29 的当前部署核对；下载示例经过离线流程验证。规格表表示当前接口接受范围，不代表每个比例、时长、参考素材组合都重新执行了付费生成。模型、分组或价格调整后，以当前模型广场、自己的模型列表和实际账单为准。