grok-video-3 视频生成 API 对接配置教程

本文基于 grok-video-3 视频生成模型官方接口规范，提供完整、可直接落地的对接配置指南，适配基础请求地址 https://api.6ai.chat，适用于后端集成、客户端调用等技术场景。

一、接口基础信息

项	说明
接口功能	基于文本提示词 + 垫图生成视频
请求方式	POST
接口地址	https://api.6ai.chat/v1/video/create
数据格式	请求/响应均为 `application/json`
异步特性	提交后返回任务 ID，需通过查询接口轮询结果

二、认证与请求头配置

调用接口必须在请求头中完成身份校验与格式声明，以下 Header 为必填项：

http 复制代码

# 身份鉴权
Authorization: Bearer {你的API Token/Key}
# 声明请求体格式
Content-Type: application/json
# 声明响应接受格式
Accept: application/json

Authorization：固定前缀 Bearer 后拼接平台分配的密钥，空格不可省略。
无额外签名/加密逻辑，直接按上述格式配置即可通过鉴权。

三、请求体参数详解

请求体为 JSON 格式，所有标注必需的字段不可缺省，参数定义如下：

参数名	类型	是否必需	说明
model	string	是	固定值：`grok-video-3`
prompt	string	是	视频生成提示词，支持追加模式参数如 `--mode=custom`
aspect_ratio	string	是	视频比例，可选：`2:3` / `3:2` / `1:1`
size	string	是	分辨率，暂仅支持 720P
images	array $string$	是	垫图图片 URL 数组，垫图后视频尺寸跟随图片尺寸

参数约束

size 仅支持 720P，传入 1080P 会被忽略或报错；
images 需传入可公网访问的图片 URL，不支持本地路径/Base64；
垫图优先级高于手动设置的尺寸，最终视频以图片尺寸为准。

四、完整请求示例

1. cURL 示例（通用调试）

bash 复制代码

curl --location -g --request POST 'https://api.6ai.chat/v1/video/create' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer 你的API密钥' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "grok-video-3",
    "prompt": "小猫在吃鱼 --mode=custom",
    "aspect_ratio": "3:2",
    "size": "720P",
    "images": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png"]
}'

2. Python 示例

python 复制代码

import requests
import json

url = "https://api.6ai.chat/v1/video/create"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer 你的API密钥",
    "Content-Type": "application/json"
}
payload = {
    "model": "grok-video-3",
    "prompt": "小猫在吃鱼 --mode=custom",
    "aspect_ratio": "3:2",
    "size": "720P",
    "images": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png"]
}

response = requests.post(url, headers=headers, data=json.dumps(payload))
print(response.json())

3. JavaScript（Axios）示例

javascript 复制代码

const axios = require('axios');
let url = 'https://api.6ai.chat/v1/video/create';
let headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer 你的API密钥',
    'Content-Type': 'application/json'
};
let data = {
    model: 'grok-video-3',
    prompt: '小猫在吃鱼 --mode=custom',
    aspect_ratio: '3:2',
    size: '720P',
    images: ['https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png']
};

axios.post(url, data, { headers })
    .then(res => console.log(res.data))
    .catch(err => console.error(err));

五、响应参数说明

成功响应（HTTP 200）

json 复制代码

{
    "id": "veo3.1-components:1762241017-xTL0P9HvGF",
    "status": "pending",
    "status_update_time": 1762241017286
}

字段名	类型	说明
id	string	视频生成任务唯一 ID，用于后续查询进度/结果
status	string	任务状态，初始为 `pending`（处理中）
status_update_time	integer	状态更新时间戳（毫秒级）

状态说明

pending：任务已接收，正在生成；
completed：生成完成，可获取视频地址；
failed：生成失败，需检查参数/图片/密钥。

六、关键注意事项

垫图规则 ：传入 images 后，视频尺寸以图片为准，aspect_ratio 与 size 可能失效；
分辨率限制 ：当前仅支持 720P，请勿传入其他分辨率；
鉴权安全 ：Bearer Token 不可暴露在前端代码/日志中，建议后端中转调用；
异步流程 ：创建接口仅提交任务，需配合视频查询接口 轮询 status，直至完成或失败；
图片要求：垫图 URL 需公网可访问、无防盗链、格式为 JPG/PNG 等常规图片格式。