Api
视频生成 API
使用 POST /api/v1/videos 创建异步视频生成任务。
创建视频任务
POST /api/v1/videos 创建异步视频生成任务；任务被接受时会消耗积分。
POST https://vidrush-ai.com/api/v1/videos
Authorization: Bearer sk-your-api-key
Content-Type: application/json请求体
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
model | 是 | string | GET /api/v1/models 返回的当前模型 ID |
prompt | 是 | string | 非空的视频指令 |
mode | 否 | string | text-to-video、image-to-video、video-to-video、frames-to-video 或 reference-to-video；必须由模型支持 |
image_urls | 否 | string[] | 公开 HTTP(S) 图片 URL；需要图片输入的模式中必填 |
video_urls | 否 | string[] | 公开 HTTP(S) 视频 URL；video-to-video 和 Motion Control 中必填 |
options | 否 | object | 模型特定的生成控制项 |
未传 mode 时默认 text-to-video；若 image_urls 非空，则会推导为 image-to-video。使用 video_urls 时，请显式传 mode: "video-to-video"。
options
| 字段 | 类型 | 说明 |
|---|---|---|
duration | string | 合法时长，例如 8s |
resolution | string | 合法分辨率，例如 720p、1080p 或 4k |
aspect_ratio | string | 合法宽高比，例如 16:9、9:16 或 Auto |
audio | boolean | 仅当模型/模式暴露音频开关时才能为 true |
source_video_duration_seconds | number | 使用 video_urls 且模型按秒计费时必填的正数源视频时长 |
只发送所选模型和模式公布的值。模型参考列出当前配置；GET /api/v1/models 是在线的机器可读事实来源。
示例
curl -X POST https://vidrush-ai.com/api/v1/videos \
-H "Authorization: Bearer $VIDRUSH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"mode": "text-to-video",
"prompt": "A paper kite crossing a bright summer sky",
"options": {
"duration": "8s",
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": true
}
}'成功响应
{
"code": 0,
"message": "ok",
"data": {
"id": "task_123",
"status": "pending",
"costCredits": 20
}
}返回前会对任务记录脱敏。使用 data.id 调用 GET /api/v1/tasks/{taskId}，每 5 秒轮询一次，直到进入终态。
旧版 /api/ai/* 端点
旧版 POST /api/ai/generate 和 POST /api/ai/query 仍可供已有集成使用，并保持旧的请求形态与响应行为。新集成应使用这里的 v1 资源端点：POST /api/v1/videos 和 GET /api/v1/tasks/{taskId}。