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

大型API聚合网
3 阅读3分钟

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

前言

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

一、接口基础信息

表格

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

二、三步极速对接（硬核可落地）

第一步：获取 API Key

  1. 打开平台官网：api.aaigc.top
  2. 注册 / 登录账号
  3. 进入 API Key / 令牌管理
  4. 复制你的 API Key（格式：sk-xxxx）

第二步：配置请求头（必填）

text

Authorization: Bearer 你的API_KEY
Content-Type: application/json
Accept: application/json

第三步：构造请求体并调用

请求参数说明

表格

参数名类型必填说明
modelstring是固定值：grok-video-3
promptstring是视频描述提示词
aspect_ratiostring是视频比例：2:3 / 3:2 / 1:1
sizestring是固定：720P
imagesarray[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，用于查询结果
statuspending：处理中；completed：已完成；failed：失败
status_update_time状态更新时间戳

五、避坑指南（必看）

  1. 仅支持 720P，传入 1080P/4K 会被忽略或报错
  2. images 必须是公网可访问 URL，不支持本地路径、Base64
  3. 视频生成是异步任务，必须轮询查询接口获取结果
  4. 抖音竖屏推荐比例：3:2 / 2:3
  5. API Key 严禁暴露在前端代码，建议后端中转调用
  6. 接口兼容 OpenAI 生态，可直接对接各类 AI 工具

六、平台优势

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

稳定中转 API 👉 api.aaigc.top

版权说明

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

avatar
文章
阅读
粉丝