grok视频

POST

{{url}}/v1/videos

最后修改时间：2026-03-15 14:10:11

OpenAI 兼容的视频生成接口，已支grok-imagine-1.0-video模型。

注意：如果传参为空值可能导致报错，所以建议删除空值传参，以提升异步任务请求成功率。

参考文档: https://platform.openai.com/docs/api-reference/videos/create

请求参数

Authorization

Header 参数

Body 参数multipart/form-data

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://api.example.com/v1/videos' \
--header 'Authorization: Bearer sk-xxx' \
--form 'model="grok-imagine-1.0-video"' \
--form 'prompt="猫咪在喝水"' \
--form 'aspect_ratio="16:9"' \
--form 'video_length="10"' \
--form 'file=@""' \
--form 'image=""' \
--form 'images=""' \
--form 'resolution_name="480p"' \
--form 'preset="fun"'

返回响应

🟢200成功

application/json

成功创建视频任务

Body

示例

{
    "id": "sora-2-123456",
    "object": "video",
    "model": "sora-2",
    "status": "queued",
    "progress": 0,
    "created_at": 1764347090922,
    "seconds": "8"
}

🟠400请求有误

修改于 2026-03-15 14:10:11

编辑图像

获取视频任务状态