给定一个提示,该模型将返回一个或多个预测的完成,并且还可以返回每个位置的替代标记的概率。
为提供的提示和参数创建完成
/v1/video/query给定一个提示,该模型将返回一个或多个预测的完成,并且还可以返回每个位置的替代标记的概率。
为提供的提示和参数创建完成
curl https://top.qingyuntop.ai/v1/video/query \
-H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}"| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
id | Query | string | 是 | 任务ID | veo3.1-fast:1770350082-trii1OXZc3 |
Content-Type | Header | string | 是 | - | application/json |
Accept | Header | string | 是 | - | application/json |
Authorization | Header | string | 否 | - | Bearer {{YOUR_API_KEY}} |
X-Forwarded-Host | Header | string | 否 | - | localhost:5173 |
model | JSON body | string | 是 | 枚举值: veo2 veo2-fast veo2-fast-frames veo2-fast-components veo2-pro veo3 veo3-fast veo3-pro veo3-pro-frames | - |
messages | JSON body | array<object> | 是 | 至今为止对话所包含的消息列表。Python 代码示例。 | - |
messages[].role | JSON body | string | 否 | - | - |
messages[].content | JSON body | string | 否 | - | - |
stream | JSON body | boolean | 否 | 默认为 false 如果设置,则像在 ChatGPT 中一样会发送部分消息增量。标记将以仅数据的服务器发送事件的形式发送,这些事件在可用时,并在 data: [DONE] 消息终止流。Python 代码示例。 | - |
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
id | 响应 JSON | string | 是 | - | - |
status | 响应 JSON | string | 是 | - | - |
video_url | 响应 JSON | null | 是 | - | - |
enhanced_prompt | 响应 JSON | string | 是 | - | - |
status_update_time | 响应 JSON | 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
}以下内容来自 Apifox 快照,可能包含兼容层字段或旧示例;公开调用请以本页的协议说明和当前模型列表为准。
{
"id": 495899697,
"name": "查询任务",
"type": "http",
"serverId": "",
"preProcessors": [],
"postProcessors": [],
"inheritPreProcessors": {},
"inheritPostProcessors": {},
"description": "给定一个提示,该模型将返回一个或多个预测的完成,并且还可以返回每个位置的替代标记的概率。\n\n为提供的提示和参数创建完成\n\n",
"operationId": "",
"sourceUrl": "",
"method": "get",
"path": "/v1/video/query",
"tags": [],
"status": 1,
"requestBody": {
"type": "multipart/form-data",
"parameters": [],
"jsonSchema": {
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "枚举值:\nveo2\nveo2-fast\nveo2-fast-frames\nveo2-fast-components\nveo2-pro\nveo3\nveo3-fast\nveo3-pro\nveo3-pro-frames"
},
"messages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string"
},
"content": {
"type": "string"
}
},
"x-apifox-orders": [
"role",
"content"
]
},
"description": "至今为止对话所包含的消息列表。Python 代码示例。"
},
"stream": {
"type": "boolean",
"description": "默认为 false 如果设置,则像在 ChatGPT 中一样会发送部分消息增量。标记将以仅数据的服务器发送事件的形式发送,这些事件在可用时,并在 data: [DONE] 消息终止流。Python 代码示例。"
}
},
"required": [
"model",
"messages"
],
"x-apifox-orders": [
"model",
"messages",
"stream"
]
},
"examples": [
{
"value": "",
"mediaType": "application/json"
}
],
"mediaType": "",
"oasExtensions": "",
"required": false,
"additionalContentTypes": []
},
"parameters": {
"path": [],
"query": [
{
"id": "7rOP7JuU9B",
"name": "id",
"required": true,
"enable": true,
"description": "任务ID\n",
"type": "string",
"sampleValue": "veo3.1-fast:1770350082-trii1OXZc3"
}
],
"cookie": [],
"header": [
{
"id": "NQs7bxnpZf",
"name": "Content-Type",
"required": true,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "application/json"
},
{
"id": "qb8tEQbCty",
"name": "Accept",
"required": true,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "application/json"
},
{
"id": "gBxcCbXhsa",
"name": "Authorization",
"required": false,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "Bearer {{YOUR_API_KEY}}"
},
{
"id": "t8P0euDZvz",
"name": "X-Forwarded-Host",
"required": false,
"enable": false,
"description": "",
"type": "string",
"sampleValue": "localhost:5173"
}
]
},
"commonParameters": {
"query": [],
"body": [],
"cookie": [],
"header": []
},
"auth": {},
"responses": [
{
"id": 116835694,
"name": "成功",
"code": 200,
"contentType": "json",
"jsonSchema": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
},
"video_url": {
"type": "null"
},
"enhanced_prompt": {
"type": "string"
},
"status_update_time": {
"type": "integer"
}
},
"required": [
"id",
"status",
"video_url",
"enhanced_prompt",
"status_update_time"
],
"x-apifox-orders": [
"id",
"status",
"video_url",
"enhanced_prompt",
"status_update_time"
]
},
"itemSchema": {},
"description": "",
"mediaType": "",
"headers": [],
"oasExtensions": ""
}
],
"responseExamples": [
{
"name": "成功示例",
"responseId": 116835694,
"data": "{\r\n \"id\": \"veo3.1-fast:1770350082-trii1OXZc3\",\r\n \"detail\": {\r\n \"id\": \"veo3.1-fast:1770350082-trii1OXZc3\",\r\n \"req\": {\r\n \"model\": \"veo3.1-fast\",\r\n \"images\": [\r\n \"https://filesystem.site/cdn/20250702/w8AauvxxPhYoqqkFWdMippJpb9zBxN.png\"\r\n ],\r\n \"prompt\": \"make animate\",\r\n \"aspect_ratio\": \"16:9\",\r\n \"enhance_prompt\": true,\r\n \"enable_upsample\": true\r\n },\r\n \"images\": [\r\n {\r\n \"url\": \"https://filesystem.site/cdn/20250702/w8AauvxxPhYoqqkFWdMippJpb9zBxN.png\",\r\n \"status\": \"completed\",\r\n \"mediaId\": \"CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM\"\r\n }\r\n ],\r\n \"status\": \"completed\",\r\n \"running\": false,\r\n \"video_url\": \"https://pro.filesystem.site/cdn/20260206/9ddbd3bdc67f75a02f766363ebf8eb.mp4\",\r\n \"created_at\": 1770350082099,\r\n \"error_sleep\": 5000,\r\n \"max_retries\": 3,\r\n \"retry_count\": 3,\r\n \"completed_at\": 1770350328994,\r\n \"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\",\r\n \"video_media_id\": \"CAUSJDU1YzFjNTliLWYxNzctNGYwYy04YTJkLTI3MGFkMWE4YjkyMxokMTZjYjk1NzUtYWY4Yy00MzQzLWI4NjMtNGQ5YWFiZTZmNzMzIgNDQUUqJGQxZjBhOGExLTUxYjYtNDk5Yy04YWJlLWFhZTU0YzZiMjIxZQ\",\r\n \"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.\",\r\n \"upsample_status\": \"MEDIA_GENERATION_STATUS_SUCCESSFUL\",\r\n \"startImageMediaId\": \"CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM\",\r\n \"status_update_time\": 1770350329098,\r\n \"upsample_video_url\": \"https://pro.filesystem.site/cdn/20260206/1b50395bad4c6c7bc22e6ada144951.mp4\",\r\n \"video_generation_id\": \"608c00e8de85d8856554201ae115b7c2\",\r\n \"veo3StartImageMediaId\": \"CAMaJGUwOTE4MTA4LWQ3MTgtNDk0OS05ZDNiLTIxMjBkM2M5ZGFkYyIDQ0FFKiQzYzY4MjJhZi05ZTVkLTRhNjktOGQ5NC1jYmNjYWVjNDhkMjM\",\r\n \"needs_safe_enhancement\": true,\r\n \"upsample_generation_id\": \"d1f0a8a1-51b6-499c-8abe-aae54c6b221e_upsampled\",\r\n \"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\",\r\n \"video_generation_status\": \"MEDIA_GENERATION_STATUS_SUCCESSFUL\"\r\n },\r\n \"status\": \"completed\",\r\n \"video_url\": \"https://pro.filesystem.site/cdn/20260206/1b50395bad4c6c7bc22e6ada144951.mp4\",\r\n \"status_update_time\": 1770350329098\r\n}",
"description": "",
"oasKey": "",
"oasExtensions": "",
"id": "019fc09b-0b1b-75fb-87f0-36836c7e1b1a"
}
],
"codeSamples": [],
"projectId": 8662722,
"moduleId": 8310462,
"folderId": 92436132,
"ordering": 12,
"responsibleId": 0,
"commonResponseStatus": {},
"advancedSettings": {
"disabledSystemHeaders": {},
"isDefaultUrlEncoding": 1
},
"customApiFields": {},
"oasExtensions": "",
"mockScript": {},
"createdAt": "2026-08-02T03:53:34.000Z",
"updatedAt": "2026-08-06T12:15:55.000Z",
"creatorId": 2863449,
"editorId": 2863449,
"creatorUserId": 2863449,
"editorUserId": 2863449,
"responseChildren": [],
"visibility": "INHERITED",
"securityScheme": {},
"callbacks": ""
}