查询与下载(Vega 格式)
查询 Vega 图片生成任务的进度与结果并下载图片,与提交任务配套使用。提交后用返回的 task_id 轮询,直到 status 变为 SUCCESS 或 FAILURE,建议每 2~3 秒一次。
端点
- 查询任务状态:
GET /v1/tasks/{task_id} - 下载图片:
GET /v1/tasks/{task_id}/artifacts
认证
请求头携带 Bearer 令牌:
路径参数
查询任务状态
GET /v1/tasks/{task_id}
响应体
状态取值:
响应示例
NOTE
查询响应里不含图片。status 变为 SUCCESS 后,请再调下方下载图片接口取图。
下载图片
GET /v1/tasks/{task_id}/artifacts
响应体
响应示例
WARNING
content_url 是临时地址:带签名、有时效,不要当长期图片链接分发或写入数据库。拿到后请立即下载转存到自己的存储,地址过期后再请求会返回 502(见提交任务的错误码)。
图片内容也可以直接打内容端点获取,二者取到的是同一份内容:
注意这条不带 ?access= 的地址需要带令牌(Authorization: Bearer sk-你的令牌);上一步 artifacts[].content_url 里已带 ?access=,那种形式才免令牌。
轮询示例
从提交到取图的完整流程(也可从第 2 步开始,换成你已有的 task_id):
计费按上游实际返回的用量结算(提交 0 预扣、失败不扣费),各模型实测消耗见提交任务页的计费。
