---
title: 图片异步任务
description: 先创建图片任务，再使用相同密钥查询状态与结果。
api: "POST /v1/images/generations/async"
---

<RequestExample>
```bash 提交
curl -i https://sub.vcnovb.cn/v1/images/generations/async \
  -H "Authorization: Bearer $VC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"夜色中的玻璃温室，植物繁茂","n":1,"size":"1024x1024"}'
```
```bash 查询
# 将 TASK_ID 替换为提交响应中的任务标识；优先使用返回的 poll_url
curl https://sub.vcnovb.cn/v1/images/tasks/TASK_ID \
  -H "Authorization: Bearer $VC_API_KEY"
```
</RequestExample>

## 可用范围

使用已开通异步图片能力的分组。若返回 `async image tasks are not enabled`，可改用[同步图片接口](/api/images)。

## 处理流程

1. 提交与同步生成一致的图片参数，**不要设置 `stream: true`**。
2. 读取 HTTP 202、任务标识和 `poll_url`；也可读取 `Location` 响应头。
3. 使用创建任务的同一把 Key 查询。若有 `Retry-After`，按其建议间隔轮询。
4. 任务完成后读取结果并保存；失败时保留任务 ID 与错误信息。

异步编辑对应 `POST /v1/images/edits/async`，同样需要分组及模型支持。

## 任务结果与退款

使用提交响应中的 `poll_url` 获取任务状态与结果。响应含有效期或退款信息时，可一并读取；费用明细可在[使用记录](/guides/usage)查看。

查询超时后继续查询原任务。任务失败时查看错误信息；退款处理中请等待入账，再核对最终费用。

<Note>查询和下载使用创建任务的同一把 API Key。任务结束前请保留密钥及其分组绑定。</Note>