Grok Imagine Video 1.5 API

价格(按秒计)

费用 = 单价 × 时长(秒),文生视频与图生视频同价,参考图不额外收费。失败不扣费。

创建任务

POST /api/v1/video/generations —— 异步:创建后轮询同一个端点取结果。

# Step 1: Create task (text-to-video; add "images" for image-to-video)
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "A calm coastal shoreline at sunset, camera slowly pushing forward",
    "resolution": "720p",
    "duration": 10,
    "aspect_ratio": "16:9"
  }'

# Step 2: Poll status
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

请求参数

取回结果

创建接口立即返回 data.taskId,视频在后台生成。带上这个 task_id 向同一个端点发 GET,读 data.state:pending 表示还在跑,completed 时 data.resultUrls[0] 就是 MP4 地址(H.264 视频 + AAC 音轨),failed 时 data.failMsg 是原因。不想轮询就传 callback_url,任务结束后我们主动 POST 通知你。

• 实测出片:4 秒的片子约 30-70 秒返回(文生更快,图生稍慢)。
• 结果视频保存 7 天后自动删除,请及时下载或转存。
• 调用成功后扣费,失败不扣费。

使用要点

• 原生音轨:模型在生成画面的同时产出同步音频(对话 / 音效 / 环境音),不需要额外的配音步骤;实测 480p 输出为 848×480、24fps。
• 成片无水印——两类请求(文生、图生)我们都逐帧抽查过。
• 图生视频对参考图的还原度很好:构图、主体、材质都保得住,prompt 用来描述你要的运动和镜头。
• 1080p 带图的规则来自模型本身:多张参考图的「参考生视频」封顶 720p,只有单张图的「首帧图生视频」能出 1080p。所以 1080p 时只传 1 张,视频会从这张图开始;不传 aspect_ratio 则成片跟图的比例(竖图出竖片),传了就按你指定的。传 2 张以上会在创建时直接收到 400,改成 720p 即可。
• 480p / 720p 时图片按参考图模式处理(保主体和构图,最多 7 张),这一点没有变化。
• 参考图直接传 base64 也可以——我们会自动转成可访问的 URL 再交给模型,和传 URL 的效果一致。
• 参考视频编辑(video-to-video)暂未开放;传参考视频会收到明确的 400 报错而不是静默忽略。
• 鉴权与其它模型一致:Header 带 Authorization: Bearer YOUR_API_KEY,同一把 key 可调平台上所有视频、图片、语音和 LLM 模型。

限制与注意事项

下面每一条都是模型或上游的硬限制,不是平台加的;超出的请求在创建时就会被 400 拒掉(不建任务、不扣费),而不是跑到一半失败。

常见 400 错误

参数问题在创建时就同步返回 400({"code": 400, "msg": "..."}),不会建任务、不扣费。msg 原文如下,可以直接按字符串匹配。

生成阶段才失败的任务(上游报错、超时等)状态为 failed,原因在 data.failMsg,费用自动退回。

相关