GET
/tencent-vod/v1/query/{task_id}获取请求结果
API Key none
腾讯 AIGC 异步协议
调用与返回说明
腾讯 AIGC 生图接口采用创建任务、保存 task_id、查询完成状态和读取结果的异步流程。请按页面定义区分任务创建响应和最终结果。
请求时注意
- 请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
- 模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。
- 异步创建返回的是公开任务或 request ID。请原样保存 ID，并只使用页面对应的查询接口继续读取，不要猜测其他前缀或把上游 ID 当作本站 ID。
返回时注意
- HTTP 2xx 只表示创建或查询请求被接受；业务成功要检查响应体中的状态字段和结果字段。失败、取消、超时或未完成状态不能当作可下载图片。
- 查询接口返回的结果 URL、文件 key 或 output 字段可能为空，直到任务进入终态；下载时按页面返回的地址和有效期处理。
Request
请求
/tencent-vod/v1/query/{task_id}Body
可选GET 请求无需 JSON 请求体，只需发送页面列出的请求头和路径、查询参数。
路径、查询与 Header 参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
task_id | Path | string | 是 | - | - |
Authorization | Header | string | 是 | 必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。 | Bearer YOUR_API_KEY |
Response返回响应
HTTP 响应返回响应 200
响应 200object腾讯 AIGC 异步协议
调用与返回说明
腾讯 AIGC 生图接口采用创建任务、保存 task_id、查询完成状态和读取结果的异步流程。请按页面定义区分任务创建响应和最终结果。
请求时注意
- 请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
- 模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。
- 异步创建返回的是公开任务或 request ID。请原样保存 ID，并只使用页面对应的查询接口继续读取，不要猜测其他前缀或把上游 ID 当作本站 ID。
返回时注意
- HTTP 2xx 只表示创建或查询请求被接受；业务成功要检查响应体中的状态字段和结果字段。失败、取消、超时或未完成状态不能当作可下载图片。
- 查询接口返回的结果 URL、文件 key 或 output 字段可能为空，直到任务进入终态；下载时按页面返回的地址和有效期处理。