Veo 统一查询 - QuickRouter API 中转接口
▼
Authorization
在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
概述
给定一个提示，该模型将返回一个或多个预测的完成，并且还可以返回每个位置的替代标记的概率。 为提供的提示和参数创建完成
请求参数
Header 参数
Content-Type
string
必需
示例: application/json
Accept
string
必需
示例: application/json
Authorization
string
可选
示例: Bearer {{YOUR_API_KEY}} X-Forwarded-Host
string
可选
示例: api.quickrouter.ai
Body 参数 application/json
multipart/form-data
可选
object
可选
请求
示例
{
"id": "veo3.1-fast:1770350082-trii1OXZc3",
"detail": {
"id": "veo3.1-fast:1770350082-trii1OXZc3",
"req": {
"model": "veo3.1-fast",
"images": [
"https://filesystem.site/cdn/20250702/w8AauvxxPhYoqqkFWdMippJpb9zBxN.png"
],
"prompt": "make animate",
"aspect_ratio": "16:9",
"enhance_prompt": true,
"enable_upsample": true
},
"images": [
{
"url": "https://filesystem.site/cdn/20250702/w8AauvxxPhYoqqkFWdMippJpb9zBxN.png",
"status": "completed",
"mediaId": "CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM"
}
],
"status": "completed",
"running": false,
"video_url": "https://pro.filesystem.site/cdn/20260206/9ddbd3bdc67f75a02f766363ebf8eb.mp4",
"created_at": 1770350082099,
"error_sleep": 5000,
"max_retries": 3,
"retry_count": 3,
"completed_at": 1770350328994,
"error_message": "[403] Request failed with status code 403 | Message: reCAPTCHA evaluation failed | Code: 403 | Status: PERMISSION_DENIED | Reason: PUBLIC_ERROR_SOMETHING_WENT_WRONG | Type: type.googleapis.com/google.rpc.ErrorInfo | URL: /v1/video:batchAsyncGenerateVideoStartImage",
"video_media_id": "CAUSJDU1YzFjNTliLWYxNzctNGYwYy04YTJkLTI3MGFkMWE4YjkyMxokMTZjYjk1NzUtYWY4Yy00MzQzLWI4NjMtNGQ5YWFiZTZmNzMzIgNDQUUqJGQxZjBhOGExLTUxYjYtNDk5Yy04YWJlLWFhZTU0YzZiMjIxZQ",
"enhanced_prompt": "Create a vibrant and whimsical animation that features a joyful scene of colorful animals playing together in a sunny meadow, surrounded by blooming flowers and butterflies fluttering by.",
"upsample_status": "MEDIA_GENERATION_STATUS_SUCCESSFUL",
"startImageMediaId": "CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM",
"status_update_time": 1770350329098,
"upsample_video_url": "https://pro.filesystem.site/cdn/20260206/1b50395bad4c6c7bc22e6ada144951.mp4",
"video_generation_id": "608c00e8de85d8856554201ae115b7c2",
"veo3StartImageMediaId": "CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM",
"needs_safe_enhancement": true,
"upsample_generation_id": "d1f0a8a1-51b6-499c-8abe-aae54c6b221e_upsampled",
"video_generation_error": "your request contains unsafe prompt or images, such as porn, violence, minors etc., has been rejected by google, please change your prompt or images and try again",
"video_generation_status": "MEDIA_GENERATION_STATUS_SUCCESSFUL"
},
"status": "completed",
"video_url": "https://pro.filesystem.site/cdn/20260206/1b50395bad4c6c7bc22e6ada144951.mp4",
"status_update_time": 1770350329098
}请求示例代码
curl --location --request GET 'https://api.quickrouter.ai/v1/video/query' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
返回响应
响应参数 🟢 200 OK · application/json
id
string
必需
status
string
必需
video_url
null
必需
enhanced_prompt
string
必需
status_update_time
integer
必需
{ "id": "veo3.1-fast:1770350082-trii1OXZc3", "detail": { "id": "veo3.1-fast:1770350082-trii1OXZc3", "req": { "model": "veo3.1-fast", "images": [ "https://filesystem.site/cdn/20250702/w8AauvxxPhYoqqkFWdMippJpb9zBxN.png" ], "prompt": "make animate", "aspect_ratio": "16:9", "enhance_prompt": true, "enable_upsample": true }, "images": [ { "url": "https://filesystem.site/cdn/20250702/w8AauvxxPhYoqqkFWdMippJpb9zBxN.png", "status": "completed", "mediaId": "CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM" } ], "status": "completed", "running": false, "video_url": "https://pro.filesystem.site/cdn/20260206/9ddbd3bdc67f75a02f766363ebf8eb.mp4", "created_at": 1770350082099, "error_sleep": 5000, "max_retries": 3, "retry_count": 3, "completed_at": 1770350328994, "error_message": "[403] Request failed with status code 403 | Message: reCAPTCHA evaluation failed | Code: 403 | Status: PERMISSION_DENIED | Reason: PUBLIC_ERROR_SOMETHING_WENT_WRONG | Type: type.googleapis.com/google.rpc.ErrorInfo | URL: /v1/video:batchAsyncGenerateVideoStartImage", "video_media_id": "CAUSJDU1YzFjNTliLWYxNzctNGYwYy04YTJkLTI3MGFkMWE4YjkyMxokMTZjYjk1NzUtYWY4Yy00MzQzLWI4NjMtNGQ5YWFiZTZmNzMzIgNDQUUqJGQxZjBhOGExLTUxYjYtNDk5Yy04YWJlLWFhZTU0YzZiMjIxZQ", "enhanced_prompt": "Create a vibrant and whimsical animation that features a joyful scene of colorful animals playing together in a sunny meadow, surrounded by blooming flowers and butterflies fluttering by.", "upsample_status": "MEDIA_GENERATION_STATUS_SUCCESSFUL", "startImageMediaId": "CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM", "status_update_time": 1770350329098, "upsample_video_url": "https://pro.filesystem.site/cdn/20260206/1b50395bad4c6c7bc22e6ada144951.mp4", "video_generation_id": "608c00e8de85d8856554201ae115b7c2", "veo3StartImageMediaId": "CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM", "needs_safe_enhancement": true, "upsample_generation_id": "d1f0a8a1-51b6-499c-8abe-aae54c6b221e_upsampled", "video_generation_error": "your request contains unsafe prompt or images, such as porn, violence, minors etc., has been rejected by google, please change your prompt or images and try again", "video_generation_status": "MEDIA_GENERATION_STATUS_SUCCESSFUL" }, "status": "completed", "video_url": "https://pro.filesystem.site/cdn/20260206/1b50395bad4c6c7bc22e6ada144951.mp4", "status_update_time": 1770350329098 }
常见错误
- 401 认证失败：检查 API Key 是否正确
- 429 请求限流：降低调用频率或升级套餐
- 500 服务器错误：稍后重试
注意事项
- 请确保 API Key 有足够的余额
- 请求频率受 API 限制，请参考价格页面