创建 Grok 视频任务（生成 / 编辑）
POST
https://api.147ai.cn/v1/videos
模型差异与选择建议
| 对比项 | grok-imagine-video-1.5 | grok-imagine-video-edit |
|---|---|---|
| 适合场景 | 新建视频；支持文生、单首帧图生、多参考图 | 修改已有视频中的指定元素 |
| Content-Type | application/json | 公网 URL / data URL 用 application/json；本地文件用 multipart/form-data |
| 必填核心字段 | model、prompt；建议传 seconds，并传 size 或 aspect_ratio | model、prompt、video |
| 时长 | 文生/单图最长 15 秒；多参考图最长 10 秒 | 源视频最长 8.7 秒 |
| 画幅 | 720x1280、1280x720、1024x1792、1792x1024；更多比例用 aspect_ratio | 跟随源视频 |
| 参考图/源视频 | 单图 input_reference；多图 reference_images，最多 7 张 | video.url 支持公网 URL 或 data URL；multipart 支持 video=@source.mp4 |
调用模式参数速查
| 模式 | Content-Type | 必填参数 | 可选参数 | 关键限制 | 对应示例 |
|---|---|---|---|---|---|
| 文生视频 | application/json | model、prompt | seconds、size、aspect_ratio、resolution | seconds 必须是字符串；文生最长 15 秒；resolution 支持 480p/720p | 见「文生视频」 |
| 单首帧图生视频 | application/json | model、prompt、input_reference | seconds、size、aspect_ratio、resolution | input_reference 传公网 URL 或 data URL；本地图片需转 data URL 或先上传公网；最长 15 秒 | 见「单首帧图生视频」 |
| 多参考图视频 | application/json | model、prompt、reference_images | seconds、size、aspect_ratio、resolution | reference_images 最多 7 张；最长 10 秒；不能同时传 input_reference | 见「多参考图视频」 |
| 视频编辑（公网 URL） | application/json | model、prompt、video.url | 无 | 源视频 <=8.7s、<=25MB、H.264 MP4；输出跟随源视频 | 见「视频编辑（公网 URL）」 |
| 视频编辑（base64 data URL） | application/json | model、prompt、video.url | 无 | video.url 使用 data:video/mp4;base64,...；平台自动临时转存，约 2h 清理 | 见「视频编辑（data URL）」 |
| 视频编辑（multipart 文件） | multipart/form-data | model、prompt、video | 无 | video=@source.mp4；平台自动临时转存，约 2h 清理 | 见「视频编辑（multipart 文件）」 |
参数规则补充
seconds 必须传字符串，例如 "6"。1080p。size=960x960；方形视频请使用 aspect_ratio=1:1。1024x1792/1792x1024 是等价画幅，实际输出仍为 720p 档，不是更高清。input_reference）或多参考图（reference_images），不支持首尾帧。input_reference 与多图 reference_images 不可同时使用。seconds、size、aspect_ratio、resolution；这些生成参数不会控制编辑输出。<=8.7s、<=25MB、H.264 MP4。data URL / multipart 文件会由平台自动临时转存，约 2h 清理。2026-06-18 实测结果
data:video/mp4;base64,...、multipart video=@source.mp4 三种传法均创建成功并完成，输出均为 720x1280、6.042s。视频编辑推荐流程
grok-imagine-video-edit 最推荐的用法是：先用 grok-imagine-video-1.5 出片，再把生成结果里的 video_url 作为编辑源传给编辑模型。1.
grok-imagine-video-1.5 创建视频任务。2.
GET /v1/videos/{task_id}，直到返回 status=completed。3.
video_url。4.
grok-imagine-video-edit，将上一步的 video_url 放到 video.url，或将本地源视频转为 data URL / multipart 文件上传。5.
video_url。可复制 curl 示例
sk-xxx 替换为你的 API Key。文生视频（JSON）
单首帧图生视频（JSON）
单首帧本地图片（data URL）
多参考图视频（JSON）
生成视频后再编辑（JSON）
视频编辑（JSON）
视频编辑（base64 data URL）
视频编辑（multipart 文件上传）
请求参数
Header 参数
Body 参数application/json必填
请求示例代码
返回响应
修改于 2026-07-16 07:49:49