三步极速对接 Grok-Video-3 视频生成 API

前言

Grok-Video-3 是当前主流的高性能 AI 视频生成模型，支持文本提示 + 垫图引导 双模式生成，输出流畅、画质稳定。本文基于 Apifox 标准接口规范 ，以 https://api.aaigc.top 为中转地址，提供极简三步对接方案，无复杂配置、复制即可运行，支持后端、客户端、第三方工具快速集成。

一、接口基础信息

项目	说明
模型标识	grok-video-3
接口功能	文本生成视频 / 图片引导生成视频
请求方式	POST
数据格式	application/json
接口类型	异步任务（提交 → 查询 → 获取结果）
基础域名	https://api.aaigc.top
提交任务地址	https://api.aaigc.top/v1/video/create

二、三步极速对接

第一步：获取 API Key 与基础配置

访问平台：https://api.aaigc.top
注册/登录后进入 API Key 管理
复制密钥（格式：sk-xxxxxxxx）
固定基础地址：https://api.aaigc.top

第二步：请求头规范（必填）

所有请求必须携带以下请求头，鉴权失败将直接返回 401：

text 复制代码

Authorization: Bearer 你的API_KEY
Content-Type: application/json
Accept: application/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 数组（公网可访问）

三、完整可运行代码示例

1. cURL 示例（调试首选）

bash 复制代码

curl -X POST https://api.aaigc.top/v1/video/create \
-H "Authorization: Bearer 你的API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "grok-video-3",
    "prompt": "A cute cat running on the grass, healing style, high detail",
    "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.aaigc.top/v1/video/create"
headers = {
    "Authorization": "Bearer 你的API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "model": "grok-video-3",
    "prompt": "小猫在草地上欢快奔跑，治愈风，高清细节",
    "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.aaigc.top/v1/video/create";
let headers = {
    "Authorization": "Bearer 你的API_KEY",
    "Content-Type": "application/json"
};
let data = {
    model: "grok-video-3",
    prompt: "A cute cat running on the grass, healing style",
    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));

四、响应格式与状态说明

成功响应

json 复制代码

{
    "id": "veo3-xxxxxxxxx",
    "status": "pending",
    "status_update_time": 1762241017286
}

字段	说明
id	任务唯一 ID，用于查询结果
status	pending：处理中；completed：已完成；failed：失败
status_update_time	状态更新时间戳

五、关键注意事项（硬核避坑）

仅支持 720P，传入 1080P/4K 会被忽略或报错
images 必须为公网可访问 URL，不支持本地路径、Base64
异步接口：提交后必须轮询查询接口获取视频地址
抖音竖屏推荐比例：3:2 / 2:3
API Key 禁止暴露在前端，建议后端中转调用
接口遵循 Apifox 标准，兼容 OpenAI 生态工具

六、平台优势

一站式接入：GPT‑4o、Claude、Gemini、Sora2、Grok‑Video‑3
高可用、高并发、失败不计费
新用户免费额度测试
低费率、文档齐全、技术支持稳定

稳定中转 API 👉 https://api.aaigc.top

版权说明

本文为原创技术教程，采用 CC 4.0 BY-SA 协议，转载请注明出处与原文链接。

要不要我帮你把这篇文章再精简成适合抖音/小红书的短图文版本，直接配你的动漫视频发布？