API Reference

G 视频生成 API

Q: 合规？

遵守平台内容安全与服务条款。

POST grok-video-api ID 15

G 视频生成接口，用于提交视频生成任务并获取成片，参数以文档为准。

POST https://apis.xiaobao.ink/api/video/grok

获取 API Key 工作台 / 调试打开 Markdown

概述

视频生成任务
异步查询

适用场景

创意视频
快速出片

调用约定

网关 · https://apis.xiaobao.ink
鉴权 · 请求携带 key（Query 或 JSON Body，以本接口为准）
回包 · JSON；请同时校验业务码与 HTTP 状态，不要只看 200

鉴权

请求需携带平台 API Key（查询参数 key 或 JSON 字段 key，以本接口说明为准）。在控制台 API Key 管理创建密钥。

POST https://apis.xiaobao.ink/api/video/grok
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

请求示例

https://apis.xiaobao.ink/api/video/grok?key=你的密钥

详细说明

请求HEADER：

名称	值
Content-Type	application/json

请求参数说明：

名称	必填	类型	示例值	说明
key	是	string	35kj5jnlj53453kl5j43nj5	接口密钥,在控制台->密钥管理查看
prompt	是	string	一只手从画面中伸进来，递给女孩一杯外带咖啡。女孩走出画面，看起来很疲惫，然后接过咖啡，高兴地说：“谢谢！回去工作了。”说完，她走出画面，径直走向办公室的另一个区域。	描述期望视频运动的文本提示。
duration	是	number	6	生成的视频时长（秒）（6-30）。（最小值：6，最大值：30，步长：1）
resolution	否	string	480p	生成视频的分辨率。480p、720p
aspect_ratio	否	string	16:9	图像比例选择，仅适用于多图生成模式，单图模式下视频宽高参考图片宽高。 2:3 3:2 1:1 16:9 9:16
image_urls	否	string	["https://fx.com/2.png"]	提供一个外部图像 URL 作为视频生成的参考。支持最多7个图像，在提示词中引用已上传图片时，请输入 @image(n)，并在其后加一个空格（例如：@image1 海边日落）。支持 JPEG、PNG、WEBP 格式每张图像最大文件大小：10MB 使用外部图像时 Spicy 模式不可用数组最多包含七个 URL
callBackUrl	是	string	http://your-callback-url.com/complete	用于接收视频生成任务完成更新的URL地址。可选但推荐在生产环境中使用。

返回参数说明：

名称	类型	说明
code	int	状态码
msg	string	状态信息
data	string	请求结果数据集
-task_id	string	任务 ID 可与“获取任务详细信息”端点一起使用，以查询任务状态
debug	string/array	调试数据
exec_time	float	执行耗时
user_ip	string	客户端IP

返回示例

<p>{ &nbsp;&quot;code&quot;: 200, &nbsp;&quot;msg&quot;: &quot;success&quot;, &nbsp;&quot;data&quot;: { &nbsp; &nbsp;&quot;taskId&quot;: &quot;veo_task_abcdef123456&quot; &nbsp;}}</p>

错误码

响应状态码

200: 成功 - 请求已成功处理
401: 未授权 - 缺少身份验证凭据或凭据无效
402: 额度不足 - 账户额度不足，无法执行该操作
404: 未找到 - 请求的资源或接口不存在
422: 校验错误 - 请求参数未通过校验检查
429: 请求受限 - 已超过该资源的请求频率限制
455: 服务不可用 - 系统目前正在维护中
500: 服务器错误 - 处理请求时发生了意外错误
501: 生成失败 - 内容生成任务失败
505: 功能禁用 - 请求的功能目前已禁用

常见问题

如何创建 G 视频任务？

按文档提交提示词等字段与 API Key。

如何取结果？

使用对应查询/回调机制获取视频 URL。

适合什么内容？

短创意、概念片与营销草稿等生成式视频场景。

和 Seedance / 索拉如何选？

不同模型风格与限制不同，建议小流量对比后选型。

合规？