文生视频

文档版本：v1.1.0 | 最后更新：2026-07-10
本平台已完整适配 Grok (xAI) 官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

根据文本提示词生成视频。

文生视频仅 grok-imagine-video 支持。grok-imagine-video-1.5 仅支持图生视频，提交纯文本请求将返回 invalid-argument: Text-to-video is not supported for this model。

创建任务

POST https://studio.dataeyes.ai/grok/v1/videos/generations

请求头

参数	类型	必填	默认值	说明
`Content-Type`	string	是	application/json	数据交换格式
`Authorization`	string	是		鉴权信息，参考接口鉴权

请求体

参数	类型	必填	默认值	说明
`model`	string	是	grok-imagine-video	模型标识文生视频仅支持 `grok-imagine-video`
`prompt`	string	是		视频生成的文本提示词
`duration`	integer	否	8	视频时长，单位：秒范围：1-15
`aspect_ratio`	string	否	16:9	输出视频宽高比可选值：`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`
`resolution`	string	否	480p	输出视频分辨率可选值：`480p`, `720p`

请求示例

curl --request POST \
  --url 'https://studio.dataeyes.ai/grok/v1/videos/generations' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-video",
    "prompt": "一枚水晶能量火箭从火星红色沙丘上发射升空",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

响应示例

{
  "request_id": "req_abc123def456"
}

查询任务

GET https://studio.dataeyes.ai/grok/v1/videos/{request_id}

通过 request_id 轮询任务状态及结果。

请求头

参数	类型	必填	说明
`Authorization`	string	是	`Bearer {API_KEY}`

请求示例

curl --request GET \
  --url 'https://studio.dataeyes.ai/grok/v1/videos/{request_id}' \
  --header 'Authorization: Bearer <token>'

响应示例

成功（status: done）：

{
  "model": "grok-imagine-video",
  "progress": 100,
  "status": "done",
  "usage": {
    "cost_in_usd_ticks": 4200000000
  },
  "video": {
    "url": "https://vidgen.x.ai/.../video.mp4",
    "duration": 10,
    "respect_moderation": true
  }
}

处理中（status: pending）：

{
  "progress": 56,
  "status": "pending"
}

失败：

{
  "status": "failed",
  "error": {
    "code": "invalid_argument",
    "message": "Prompt cannot be empty. Please provide a prompt."
  }
}

查询响应字段

字段	类型	说明
`status`	string	任务状态：`pending`, `done`, `failed`, `expired`
`progress`	integer	生成进度（0-100）
`video.url`	string	生成的视频临时 URL（有效期 24 小时）
`video.duration`	integer	生成视频的时长（秒）
`video.respect_moderation`	boolean	内容是否通过审核；若为 false 则 url 为空
`model`	string	使用的模型
`usage.cost_in_usd_ticks`	integer	上游返回的计费金额，单位 usd_tick（1 tick = 10⁻¹⁰ 美元）
`error.code`	string	错误码
`error.message`	string	错误描述

错误处理

当视频生成失败时，响应包含 error 对象，含 code 和 message 字段。可能的错误码如下：

错误码	含义	处理建议
`invalid_argument`	请求参数无效（不支持的时长、无效的图片/视频、提示词过长、冲突的模式，或内容被审核拦截）	修正请求参数或输入媒体后重新提交
`permission_denied`	API 密钥无权执行请求的操作	确认 API 密钥权限
`failed_precondition`	当前模型或设置不支持请求的操作	更改模型、模式、分辨率或其他设置
`service_unavailable`	视频生成服务暂时过载	稍后重试
`internal_error`	服务内部错误	重试请求；如持续失败，携带 request_id 联系支持

鉴权错误、模型不存在和限流等错误在任务创建前同步返回，不会出现在上述异步错误码中。

01-文生视频

文生视频#

创建任务#

请求头#

请求体#

请求示例#

响应示例#

查询任务#

请求头#

请求示例#

响应示例#

查询响应字段#

错误处理#

文生视频

创建任务

请求头

请求体

请求示例

响应示例

查询任务

请求头

请求示例

响应示例

查询响应字段

错误处理