视频接口

视频使用独立任务接口，不使用图片的 task_id 查询路径。本站也提供 Seedance 视频模型，完整参数与参考素材写法见 SD / Seedance 接入。本页下方保留 Grok 的 grok-video-1.0 和 grok-video-1.5 示例（2026-09-16 核对），分组权限与价格见模型广场。

Grok 创建视频任务

POST /v1/videos

bash

curl --fail-with-body --max-time 120 \
  https://api.manxiaobai.online/v1/videos \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model":"grok-video-1.0",
    "prompt":"清晨的森林，镜头缓慢向前移动，阳光穿过树叶",
    "seconds":"6",
    "aspect_ratio":"16:9"
  }'

成功接纳通常返回 HTTP 200 的任务对象；读取 task_id、id 或 data.task_id，立即保存。它不是最终视频。不要因创建返回 200 就开始读取图片的 data[].url。

字段	类型	建议
model	string	使用本页两个 Grok 模型名之一
prompt	string	非空视频描述
seconds	string 或整数	明确填写；示例用字符串 `"6"`
aspect_ratio	string	1.0 常用 16:9/9:16/1:1；1.5 先选 16:9/9:16
image_urls	string array，可选	参考图 URL 或已支持的图片输入形式；建议先用公开 HTTPS 图片

生产接入优先使用 6/8/10/12/15 秒。本站参数校验也接受 4 秒，但当前部分公开渠道说明从 6 秒开始；需要 4 秒时应先确认目标分组实际支持，不能仅凭通过校验认定上游一定接受。

参考图与模型差异

JSON 可增加 image_urls:["https://你的图片域名/reference.png"]。URL 必须是服务端可访问的真实图片。multipart 可使用 input_reference 文件字段，HTTP 库负责 boundary。

当前本站对公开 Grok 模型的请求校验最多接受 7 张参考图；grok-video-1.0 使用多张参考图时最长 10 秒。通过本站校验不等于所有上游都支持这些组合；1.5 不应沿用旧文档“永远必须且只能一张”的统一结论，也不能反过来承诺所有渠道支持多图。

分辨率会受本站适配与渠道影响，当前相关适配会使用 720p；不要把传入的 size/resolution 当作精确交付承诺。本章未重新付费验证全部视频规格组合，首次集成应使用 6 秒、16:9、无参考图或单图的最小用例，再验证目标组合。

查询与下载

bash

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

保存完整响应。不同渠道可能保留不同封装，应兼容顶层 status 和 data.status，并统一大小写：

排队/处理中：queued、pending、submitted、processing、in_progress 等。
成功：completed、done、succeeded、success。
失败：failed、failure、error、cancelled、canceled 等；读取 error、fail_reason 或对应嵌套字段。

成功结果可能位于 result_url、video.url、data.result_url、data.url 或 data.video.url。轮询建议先按 3–5 秒间隔并设置截止时间；没有图片任务的统一 poll_after_ms 保证。

拿到结果后及时下载或转存，不能依赖临时视频链接永久存在。GET /v1/videos/{task_id}/content 是带鉴权的视频内容入口；能力取决于任务已有可用结果。向外部结果 URL 下载时不携带本站 Key。

兼容入口与重试

底层还提供 /v1/video/generations 及其任务查询入口。新接入优先统一使用 /v1/videos，不要把不同任务协议混在一套固定响应解析中。

视频同样可能耗时较长。拿到任务 ID 后只查询原任务，提交断线或超时不要自动重发；没有可依赖的统一取消或幂等去重承诺。反馈时提供模型、任务 ID、请求时间和脱敏结果。