视频通用接口
POST
/v1/videos
视频生成
POST /v1/videos 提交，按 model 字段调用对应模型（Veo / Grok / Sora / Nano Banana 异步生图等）。task_id，再调 GET /v1/videos/{task_id} 轮询结果。接入地址
| 线路 | Base URL | 说明 |
|---|---|---|
| 国内加速（推荐） | https://cdn.wusag.com | 走国内 CDN 节点 |
| 海外直连 | https://api.xinliu.one | 海外服务器或加速节点异常时使用 |
请求
POST {Base URL}/v1/videosAuthorization: Bearer 你的令牌Content-Type: multipart/form-data（推荐，多图、首尾帧场景必须）或 application/json表单字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 见下方"可用模型" |
prompt | string | 是 | 文本提示词 |
size | string | 否 | 分辨率，详见各模型说明 |
aspect_ratio | string | 否 | 16:9 / 9:16 / 1:1 / 2:3 / 3:2（部分模型支持） |
seconds | int | 否 | 时长，grok / sora 系列由模型尾缀固定 |
input_reference | file | 否 | 参考图（图生视频时传），可重复多次 |
remix_id | string | 否 | Veo 视频延长专用 |
用图片 URL 作为参考图（无需上传本地文件）
input_reference 字段值可以直接是公网 HTTPS 图片 URL，用 multipart 字符串值传入，不要加 @ 前缀（@ 是 curl 上传本地文件语法）。data:image/png;base64,...）同样以字符串值方式传入。本接口不接受 application/json body，使用 JSON 提交会返回 400 Field required model。可用模型
GET {Base URL}/v1/models，过滤 model_type=视频。| 系列 | model | 时长 |
|---|---|---|
| Grok Video 3 | grok-video-3 / grok-video-3-max | 6s / 10s |
| Grok Video 6s/10s/12s | grok-video-6s / grok-video-10s / grok-video-12s | 6s / 10s / 12s |
| Grok Imagine 1.0 | grok-imagine-1.0-video-20s | 20s |
| Veo 3.1 标准 | veo_3_1 / veo_3_1-fl | 720P 文生 / 首尾帧 |
| Veo 3.1 Fast | veo_3_1-fast / veo_3_1-fast-fl | 720P 文生 / 首尾帧 |
| Veo 3.1 Fast HD | veo_3_1-fast-hd / veo_3_1-fast-fl-hd | 1080P 文生 / 首尾帧 |
| Veo 3.1 Lite | veo_3_1-lite | 720P 轻量（不支持视频延长） |
| Veo 3.1 4K | veo_3_1-4K / -4K-fl / veo_3_1-fast-4K / -fast-4K-fl / veo_3_1-lite-4K | 4K 输出 |
| Veo 3.1 延长 | veo_3_1-fast-extend | 基于 remix_id 续作 |
| Sora 2 | sora-2-openai-4s ~ sora-2-openai-20s | 4/8/12/16/20s |
| 即梦 2.0 | dance2-fast-15s | 15s |
提交返回
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "video.generation",
"status": "queued",
"progress": 0,
"created_at": 1730000000
}task_id 后调 GET /v1/videos/{task_id} 轮询。注意
grok-video-3 / -3-max 旧族 size 必填且只接受 720P / 1080P 或具体像素，否则返回 500grok-video-6s / -10s / -12s 新族 size 可选，五选一：720x1280 / 1280x720 / 1024x1024 / 1024x1792 / 1792x1024/v1/videos/extend（不存在）/v1/video/create 路径，请使用本接口model 字段可能是统一别名（Grok 6s 系列返回 grok-imagine-video），轮询 GET /v1/videos/{task_id} 时返回的才是真实 model 名计费
Grok Imagine 1.0 视频系列调用方式（JSON body）
Content-Type: application/json body，支持 URL 参考图（不需要本地文件上传）。字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | grok-imagine-1.0-video-20s（20 秒视频） |
prompt | string | 是 | 文本提示词 |
reference_images | array | 否 | 公网 HTTPS URL 数组（图生视频用），最多 7 张 |
文生视频示例
图生视频示例（URL 参考图）
完成态响应（含 video_url 直链）
{
"id": "task_xxx",
"task_id": "task_xxx",
"model": "grok-imagine-1.0-video-20s",
"status": "completed",
"progress": 100,
"output": {"url": "https://.../generated_video.mp4"},
"video_url": "https://.../generated_video.mp4"
}completed 直接返回 video_url 和 output.url 两个直链字段，无需调用 /content 端点。错误码
400 参数错误401 令牌无效402 余额不足404 模型不存在429 同时进行任务数超限500 服务端错误请求示例（Grok Video 3 文生视频）
请求示例（Veo 文生视频）
提交后立即返回
{
"id": "task_uZkx29iZ9fJfyQUo9s7RecqknNxCTTlv",
"task_id": "task_uZkx29iZ9fJfyQUo9s7RecqknNxCTTlv",
"object": "video.generation",
"status": "queued",
"progress": 0,
"created_at": 1778069154
}Veo 系列提交返回会带 seconds和size字段；Grok 系列不带。
请求参数
Header 参数
Body 参数multipart/form-data
请求示例代码
返回响应
修改于 2026-05-12 11:56:09