Sora 统一查询 - QuickRouter API 中转接口
▼
Authorization
在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
概述
给定一个提示，该模型将返回一个或多个预测的完成，并且还可以返回每个位置的替代标记的概率。 为提供的提示和参数创建完成
请求参数
Query 参数
id
string
必需
任务ID 示例: sora-2:task_01kbfq03gpe0wr9ge11z09xqrj
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": "sora-2:task_01k6x15vhrff09dkkqjrzwhm60",
"detail": {
"id": "task_01k6x15vhrff09dkkqjrzwhm60",
"input": {
"size": "small",
"model": "sy_ore",
"images": [
"https://filesystem.site/cdn/20250612/VfgB5ubjInVt8sG6rzMppxnu7gEfde.png",
"https://filesystem.site/cdn/20250612/998IGmUiM2koBGZM3UnZeImbPBNIUL.png"
],
"prompt": "make animate",
"orientation": "portrait"
},
"status": "pending",
"pending_info": {
"id": "task_01k6x15vhrff09dkkqjrzwhm60",
"seed": null,
"type": "video_gen",
"user": "user-a1sGDUIOXV32hNITe59LEkHa",
"model": "sy_8",
"title": "New Video",
"width": 352,
"height": 640,
"prompt": "make animate",
"sdedit": null,
"status": "processing",
"actions": null,
"guidance": null,
"n_frames": 450,
"priority": 2,
"operation": "simple_compose",
"preset_id": null,
"created_at": "2025-10-06T15:10:26.875729Z",
"n_variants": 1,
"project_id": null,
"request_id": null,
"generations": [],
"tracking_id": null,
"progress_pct": 0.9302178175176704,
"remix_config": null,
"inpaint_items": [
{
"type": "image",
"preset_id": null,
"crop_bounds": null,
"frame_index": 0,
"cameo_file_id": null,
"generation_id": null,
"upload_media_id": "media_01k6x15tnzezbst05sth2qgd8r",
"source_end_frame": 0,
"uploaded_file_id": null,
"source_start_frame": 0
},
{
"type": "image",
"preset_id": null,
"crop_bounds": null,
"frame_index": 0,
"cameo_file_id": null,
"generation_id": null,
"upload_media_id": "media_01k6x15tzafwztz74t018v3enw",
"source_end_frame": 0,
"uploaded_file_id": null,
"source_start_frame": 0
}
],
"interpolation": null,
"is_storyboard": null,
"failure_reason": null,
"organization_id": null,
"moderation_result": {
"code": null,
"type": "passed",
"task_id": "task_01k6x15vhrff09dkkqjrzwhm60",
"is_output_rejection": false,
"results_by_frame_index": {}
},
"needs_user_review": false,
"queue_status_message": null,
"progress_pos_in_queue": null,
"num_unsafe_generations": 0,
"estimated_queue_wait_time": null
}
},
"status": "pending",
"status_update_time": 1759763621142
}请求示例代码
curl --location --request GET 'https://api.quickrouter.ai/v1/video/query?id=sora-2:task_01kbfq03gpe0wr9ge11z09xqrj' \
--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
必需
pending
可选
completed
可选
{ "id": "sora-2:task_01k6x15vhrff09dkkqjrzwhm60", "detail": { "id": "task_01k6x15vhrff09dkkqjrzwhm60", "input": { "size": "small", "model": "sy_ore", "images": [ "https://filesystem.site/cdn/20250612/VfgB5ubjInVt8sG6rzMppxnu7gEfde.png", "https://filesystem.site/cdn/20250612/998IGmUiM2koBGZM3UnZeImbPBNIUL.png" ], "prompt": "make animate", "orientation": "portrait" }, "status": "pending", "pending_info": { "id": "task_01k6x15vhrff09dkkqjrzwhm60", "seed": null, "type": "video_gen", "user": "user-a1sGDUIOXV32hNITe59LEkHa", "model": "sy_8", "title": "New Video", "width": 352, "height": 640, "prompt": "make animate", "sdedit": null, "status": "processing", "actions": null, "guidance": null, "n_frames": 450, "priority": 2, "operation": "simple_compose", "preset_id": null, "created_at": "2025-10-06T15:10:26.875729Z", "n_variants": 1, "project_id": null, "request_id": null, "generations": [], "tracking_id": null, "progress_pct": 0.9302178175176704, "remix_config": null, "inpaint_items": [ { "type": "image", "preset_id": null, "crop_bounds": null, "frame_index": 0, "cameo_file_id": null, "generation_id": null, "upload_media_id": "media_01k6x15tnzezbst05sth2qgd8r", "source_end_frame": 0, "uploaded_file_id": null, "source_start_frame": 0 }, { "type": "image", "preset_id": null, "crop_bounds": null, "frame_index": 0, "cameo_file_id": null, "generation_id": null, "upload_media_id": "media_01k6x15tzafwztz74t018v3enw", "source_end_frame": 0, "uploaded_file_id": null, "source_start_frame": 0 } ], "interpolation": null, "is_storyboard": null, "failure_reason": null, "organization_id": null, "moderation_result": { "code": null, "type": "passed", "task_id": "task_01k6x15vhrff09dkkqjrzwhm60", "is_output_rejection": false, "results_by_frame_index": {} }, "needs_user_review": false, "queue_status_message": null, "progress_pos_in_queue": null, "num_unsafe_generations": 0, "estimated_queue_wait_time": null } }, "status": "pending", "status_update_time": 1759763621142 }
常见错误
- 401 认证失败：检查 API Key 是否正确
- 429 请求限流：降低调用频率或升级套餐
- 500 服务器错误：稍后重试
注意事项
- 请确保 API Key 有足够的余额
- 请求频率受 API 限制，请参考价格页面