提交异步生图任务

正式环境

https://api.naoshengyun.com

POST

/v1/images/generations/async

提交后立即返回任务 ID；使用 GET /images/jobs/{jobid} 轮询结果。
异步接口仅支持 n=1，结果始终以托管图片 URL 返回；不支持 multipart 文件上传和 mask。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

文生图图生图

{
    "model": "gpt-image-1",
    "prompt": "一只坐在雪地中的红狐，水彩画风格，柔和晨光",
    "size": "1024x1024",
    "quality": "high"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文生图图生图

curl --location 'https://api.naoshengyun.com/v1/images/generations/async' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-image-1",
    "prompt": "一只坐在雪地中的红狐，水彩画风格，柔和晨光",
    "size": "1024x1024",
    "quality": "high"
}'

返回响应

🟢202

application/json

任务已创建。

Bodyapplication/json

示例

{
    "id": "imgjob_01J9Z3K7QF8M2N5P4R6T8W0XYZ",
    "object": "image.generation.job",
    "status": "queued",
    "created": 1730000000
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠422UnprocessableEntity

🟠429RateLimited

🔴501NotImplemented

修改于 2026-08-13 06:32:02

同步生成图像

查询异步生图任务