本文基于grok-video-3视频生成模型官方接口规范提供完整、可直接落地的对接配置指南适配基础请求地址https://api.6ai.chat适用于后端集成、客户端调用等技术场景。一、接口基础信息项说明接口功能基于文本提示词 垫图生成视频请求方式POST接口地址https://api.6ai.chat/v1/video/create数据格式请求/响应均为application/json异步特性提交后返回任务 ID需通过查询接口轮询结果二、认证与请求头配置调用接口必须在请求头中完成身份校验与格式声明以下 Header 为必填项# 身份鉴权 Authorization: Bearer {你的API Token/Key} # 声明请求体格式 Content-Type: application/json # 声明响应接受格式 Accept: application/jsonAuthorization固定前缀Bearer后拼接平台分配的密钥空格不可省略。无额外签名/加密逻辑直接按上述格式配置即可通过鉴权。三、请求体参数详解请求体为 JSON 格式所有标注必需的字段不可缺省参数定义如下参数名类型是否必需说明modelstring是固定值grok-video-3promptstring是视频生成提示词支持追加模式参数如--modecustomaspect_ratiostring是视频比例可选2:3/3:2/1:1sizestring是分辨率暂仅支持 720Pimagesarray[string]是垫图图片 URL 数组垫图后视频尺寸跟随图片尺寸参数约束size仅支持720P传入1080P会被忽略或报错images需传入可公网访问的图片 URL不支持本地路径/Base64垫图优先级高于手动设置的尺寸最终视频以图片尺寸为准。四、完整请求示例1. cURL 示例通用调试curl--location-g--requestPOSThttps://api.6ai.chat/v1/video/create\--headerAccept: application/json\--headerAuthorization: Bearer 你的API密钥\--headerContent-Type: application/json\--data-raw{ model: grok-video-3, prompt: 小猫在吃鱼 --modecustom, aspect_ratio: 3:2, size: 720P, images: [https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png] }2. Python 示例importrequestsimportjson urlhttps://api.6ai.chat/v1/video/createheaders{Accept:application/json,Authorization:Bearer 你的API密钥,Content-Type:application/json}payload{model:grok-video-3,prompt:小猫在吃鱼 --modecustom,aspect_ratio:3:2,size:720P,images:[https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png]}responserequests.post(url,headersheaders,datajson.dumps(payload))print(response.json())3. JavaScriptAxios示例constaxiosrequire(axios);leturlhttps://api.6ai.chat/v1/video/create;letheaders{Accept:application/json,Authorization:Bearer 你的API密钥,Content-Type:application/json};letdata{model:grok-video-3,prompt:小猫在吃鱼 --modecustom,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(resconsole.log(res.data)).catch(errconsole.error(err));五、响应参数说明成功响应HTTP 200{id:veo3.1-components:1762241017-xTL0P9HvGF,status:pending,status_update_time:1762241017286}字段名类型说明idstring视频生成任务唯一 ID用于后续查询进度/结果statusstring任务状态初始为pending处理中status_update_timeinteger状态更新时间戳毫秒级状态说明pending任务已接收正在生成completed生成完成可获取视频地址failed生成失败需检查参数/图片/密钥。六、关键注意事项垫图规则传入images后视频尺寸以图片为准aspect_ratio与size可能失效分辨率限制当前仅支持720P请勿传入其他分辨率鉴权安全Bearer Token不可暴露在前端代码/日志中建议后端中转调用异步流程创建接口仅提交任务需配合视频查询接口轮询status直至完成或失败图片要求垫图 URL 需公网可访问、无防盗链、格式为 JPG/PNG 等常规图片格式。