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"}'
# 将 TASK_ID 替换为提交响应中的任务标识;优先使用返回的 poll_url
curl https://sub.vcnovb.cn/v1/images/tasks/TASK_ID \
-H "Authorization: Bearer $VC_API_KEY"
图像与视频 API
图片异步任务
先创建图片任务,再使用相同密钥查询状态与结果。
POST
https://sub.vcnovb.cn
/
v1
/
images
/
generations
/
async
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"}'
# 将 TASK_ID 替换为提交响应中的任务标识;优先使用返回的 poll_url
curl https://sub.vcnovb.cn/v1/images/tasks/TASK_ID \
-H "Authorization: Bearer $VC_API_KEY"
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"}'
# 将 TASK_ID 替换为提交响应中的任务标识;优先使用返回的 poll_url
curl https://sub.vcnovb.cn/v1/images/tasks/TASK_ID \
-H "Authorization: Bearer $VC_API_KEY"
可用范围
使用已开通异步图片能力的分组。若返回async image tasks are not enabled,可改用同步图片接口。
处理流程
- 提交与同步生成一致的图片参数,不要设置
stream: true。 - 读取 HTTP 202、任务标识和
poll_url;也可读取Location响应头。 - 使用创建任务的同一把 Key 查询。若有
Retry-After,按其建议间隔轮询。 - 任务完成后读取结果并保存;失败时保留任务 ID 与错误信息。
POST /v1/images/edits/async,同样需要分组及模型支持。
任务结果与退款
使用提交响应中的poll_url 获取任务状态与结果。响应含有效期或退款信息时,可一并读取;费用明细可在使用记录查看。
查询超时后继续查询原任务。任务失败时查看错误信息;退款处理中请等待入账,再核对最终费用。
查询和下载使用创建任务的同一把 API Key。任务结束前请保留密钥及其分组绑定。