VID
视频生成 API
通过统一的接口调用多家顶级视频生成模型，支持文生视频、动作控制等能力。
快速开始
1
从控制台获取 API 密钥2
选择下方视频模型3
发送 POST 请求创建任务4
轮询 GET 请求获取视频链接认证方式
所有请求需在 Header 中携带 Bearer Token：
Authorization: Bearer YOUR_API_KEY
接口端点
POST
/api/v1/video/generations创建视频生成任务
GET
/api/v1/video/generations?task_id=xxx查询任务状态并获取视频链接
API 参考
选择模型提供商查看对应的参数和示例
xAI
Grok Video
xAI 出品的高质量文生视频模型，支持 5秒/10秒/15秒 视频生成，动作自然流畅。
可用模型
Grok Video 3
grok-video-3$0.08
5秒 · 标准版
Grok Video 3 (10秒)
grok-video-3-10s$0.08
10秒 · 音画同出
Grok Video 3 (Official)
grok-video-3-official$0.08
6/10/15秒 · 官方渠道，支持参考图
请求参数
model必填
stringgrok-video-3 / grok-video-3-10s / grok-video-3-officialprompt必填
string视频内容描述文本aspect_ratio
string"16:9"（默认）、"1:1"、"9:16"、"2:3"、"3:2"size
string"720P"（默认）、"1080P"callback_url
string任务完成后的回调 URL说明
- -5秒视频约30秒生成，10秒视频约60秒
- -支持 16:9、9:16、1:1 等宽高比
代码示例
# Step 1: Create task
curl -X POST https://apimodels.app/api/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-video-3",
"prompt": "A cat playing piano in a jazz club, cinematic lighting",
"aspect_ratio": "16:9"
}'
# Step 2: Poll status
curl "https://apimodels.app/api/v1/video/generations?task_id=TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"响应格式
创建任务响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "pending"
}
}成功响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "completed",
"resultUrls": ["https://cdn.example.com/video.mp4"],
"createTime": 1705123450000,
"completeTime": 1705123500000
}
}失败响应
{
"code": 200,
"msg": "success",
"data": {
"taskId": "clxxx...",
"state": "failed",
"failMsg": "Content policy violation"
}
}任务状态
pending任务已排队，等待处理processing视频生成中completed生成成功，可获取视频链接failed生成失败错误码
400请求参数错误或缺失401API 密钥无效402积分不足404任务 ID 不存在500服务器内部错误注意事项
- -视频文件保存 7 天，请及时下载
- -建议每 5-10 秒轮询一次任务状态
- -长时间任务建议使用 callback_url 回调
- -生产环境请妥善保管 API 密钥