给定一个提示，该模型将返回一个或多个预测的完成，并且还可以返回每个位置的替代标记的概率。
为提供的提示和参数创建完成
GET
/v1/video/query查询任务
API Key multipart/form-data
请求示例
curl https://top.qingyuntop.ai/v1/video/query \
-H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}"请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
id | Query | string | 是 | 任务ID | grok:ea57ae4e-3745-499f-947f-2a7829010d70 |
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 代码示例。 | - |
返回响应 (200)
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
id | 响应 JSON | string | 是 | - | - |
status | 响应 JSON | string | 是 | - | - |
video_url | 响应 JSON | null | 是 | - | - |
enhanced_prompt | 响应 JSON | string | 是 | - | - |
status_update_time | 响应 JSON | integer | 是 | - | - |
响应示例
{
"id": "033fa60e-f37c-4ff6-a44d-5585ffea938d",
"status": "pending",
"video_url": null,
"enhanced_prompt": "```\nA surreal and whimsical digital painting of a majestic brown cow with large, feathered wings soaring gracefully through a vibrant blue sky. The cow has a joyful expression, its tail streaming behind it as it flies among fluffy white clouds. Below, a patchwork of green farmland stretches into the distance, with tiny farm buildings and a group of astonished farmers looking up in amazement. The scene is bathed in warm golden sunlight, creating a dreamlike and magical atmosphere. Art style inspired by fantasy illustrations with soft brushstrokes and rich, saturated colors.\n```",
"status_update_time": 1750323167003
}来源原始接口定义（用于追溯）
以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。
{
"id": 497673353,
"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": "grok:ea57ae4e-3745-499f-947f-2a7829010d70"
}
],
"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": 182113285,
"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": 182113285,
"data": "{\r\n \"id\": \"033fa60e-f37c-4ff6-a44d-5585ffea938d\",\r\n \"status\": \"pending\",\r\n \"video_url\": null,\r\n \"enhanced_prompt\": \"```\\nA surreal and whimsical digital painting of a majestic brown cow with large, feathered wings soaring gracefully through a vibrant blue sky. The cow has a joyful expression, its tail streaming behind it as it flies among fluffy white clouds. Below, a patchwork of green farmland stretches into the distance, with tiny farm buildings and a group of astonished farmers looking up in amazement. The scene is bathed in warm golden sunlight, creating a dreamlike and magical atmosphere. Art style inspired by fantasy illustrations with soft brushstrokes and rich, saturated colors.\\n```\",\r\n \"status_update_time\": 1750323167003\r\n}",
"description": "",
"oasKey": "",
"oasExtensions": "",
"id": "019fd25e-4be7-74fc-a46e-84448f7337a8"
},
{
"name": "成功示例",
"responseId": 182113285,
"data": "{\r\n \"id\": \"grok:299604b7-c5ea-47b5-bc64-c06f300f0d27\",\r\n \"mode\": \"text\",\r\n \"type\": \"create\",\r\n \"error\": \"\",\r\n \"model\": \"grok-3\",\r\n \"ratio\": \"3:2\",\r\n \"prompt\": \"cat fish --mode=custom\",\r\n \"status\": \"completed\",\r\n \"post_id\": \"393ae1ec-1dc7-4f26-bb53-afe361bc3b3a\",\r\n \"asset_id\": \"393ae1ec-1dc7-4f26-bb53-afe361bc3b3a\",\r\n \"progress\": 100,\r\n \"trace_id\": \"4cc3a75aa6d6a0788f86195e0cbad44e\",\r\n \"upscaled\": false,\r\n \"video_id\": \"393ae1ec-1dc7-4f26-bb53-afe361bc3b3a\",\r\n \"video_url\": \"https://soruxgpt-saas-yimeng.soruxgpt.com/file_download/ca10efbb-ae64-426e-99f0-f365bc3cd941.mp4\",\r\n \"completed_at\": 1764522552,\r\n \"thumbnail_url\": \"https://soruxgpt-saas-yimeng.soruxgpt.com/file_download/f4fd6fe4-8091-4528-be32-335f4fc9af65.jpg\",\r\n \"video_file_id\": \"ca10efbb-ae64-426e-99f0-f365bc3cd941\",\r\n \"thumbnail_file_id\": \"f4fd6fe4-8091-4528-be32-335f4fc9af65\",\r\n \"status_update_time\": 1764522552,\r\n \"upscale_on_complete\": false\r\n}",
"description": "",
"oasKey": "",
"oasExtensions": "",
"id": "019fd700-6415-724a-a45b-3b4bfffd1610"
}
],
"codeSamples": [],
"projectId": 8662722,
"moduleId": 8310462,
"folderId": 92749338,
"ordering": 6,
"responsibleId": 0,
"commonResponseStatus": {},
"advancedSettings": {
"disabledSystemHeaders": {},
"isDefaultUrlEncoding": 1
},
"customApiFields": {},
"oasExtensions": "",
"mockScript": {},
"createdAt": "2026-08-05T14:40:23.000Z",
"updatedAt": "2026-08-06T12:15:55.000Z",
"creatorId": 2863449,
"editorId": 2863449,
"creatorUserId": 2863449,
"editorUserId": 2863449,
"responseChildren": [],
"visibility": "INHERITED",
"securityScheme": {},
"callbacks": ""
}