跳转到主要内容
POST
https://octopusx.ai
/
v1
/
videos
curl -X POST https://octopusx.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "清晨的城市街道，阳光穿过树叶，镜头缓慢向前移动",
    "seconds": "8",
    "aspect_ratio": "16:9",
    "resolution": "720P"
  }'

{
  "id": "video_abc123",
  "object": "video",
  "model": "grok-imagine-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600,
  "seconds": "6",
  "size": "720P",
  "video_url": ""
}

​
Grok Imagine Video

grok-imagine-video 是 Grok Imagine 系列的视频生成模型。该模型使用 JSON 请求体，支持文生视频和参考图视频生成。
  • 接口路径是 POST /v1/videos。
  • 请求格式是 application/json。
  • 文生视频只需要 model、prompt、seconds、aspect_ratio、resolution。
  • 图生视频单图使用 image，多图使用 images。
  • resolution 支持 480P 和 720P。
  • prompt 最多支持 4096 个字符。

​
方法与路径

POST /v1/videos

curl -X POST https://octopusx.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "清晨的城市街道，阳光穿过树叶，镜头缓慢向前移动",
    "seconds": "8",
    "aspect_ratio": "16:9",
    "resolution": "720P"
  }'

​
响应示例

{
  "id": "video_abc123",
  "object": "video",
  "model": "grok-imagine-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600,
  "seconds": "6",
  "size": "720P",
  "video_url": ""
}

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
必填
固定传 grok-imagine-video。
​
prompt
string
必填
视频生成提示词。最多 4096 个字符。
​
seconds
string
目标秒数。最小为 1 秒；建议按字符串传入，例如 "6"。
​
aspect_ratio
string
宽高比。支持常见预设 1:1、16:9、9:16、4:3、3:4、3:2、2:3、2:1、1:2、19.5:9、9:19.5、20:9、9:20，也支持 数字:数字 的自定义比例。
​
resolution
string
输出清晰度。支持 480P、720P，也兼容 480、720 写法。
​
image
string
单张参考图。使用 data:image/png;base64,... 这类 data URI。
​
images
array<string>
多张参考图。数组成员使用 data:image/png;base64,... 这类 data URI。传多张图时不要同时传 image。

​
Response

​
id
string
任务 ID。后续用 GET /v1/videos/{id} 查询结果。
​
object
string
对象类型，通常为 video。
​
model
string
实际提交的模型名。
​
status
string
任务状态，常见值有 queued、processing、completed、failed、cancelled。
​
progress
integer
任务进度百分比。
​
video_url
string
任务完成后的视频地址。也可以使用 GET /v1/videos/{task_id}/content 下载结果。

​
与 Grok 1.5 / 3 的区别

项目grok-imagine-videogrok-video-1.5 / grok-video-3
请求格式JSONmultipart/form-data
图片字段image / imagesinput_reference
清晰度字段resolutionsize
清晰度值480P、720P480P、540P、720P、1080P
时长规则自定义秒数，最小 1s10s 对应 Pro 档，15s 对应 Max 档

​
相关接口