提交异步编辑任务

正式环境

https://api.naoshengyun.com

POST

/v1/images/edits/async

提交异步图片编辑任务。请求校验并入队成功后立即返回 task_id，不等待图片编辑完成；使用查询异步生图任务接口轮询状态和结果。JSON 请求中的 image 支持单个或多个 URL、Base64、data URI。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
  "model": "gpt-image-2",
  "prompt": "在图片中添加一个太阳，要有阳光照射下来",
  "image": "https://media-test.com/tokz7QRyclDExc1zgQF7nCvbK1lrrt1A.png",
  "n": 1,
  "size": "1024x1024",
  "response_format": "url"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.naoshengyun.com/v1/images/edits/async' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "model": "gpt-image-2",
  "prompt": "在图片中添加一个太阳，要有阳光照射下来",
  "image": "https://media-test.com/tokz7QRyclDExc1zgQF7nCvbK1lrrt1A.png",
  "n": 1,
  "size": "1024x1024",
  "response_format": "url"
}'

返回响应

🟢200任务已提交

application/json

任务提交成功后返回任务标识。

Bodyapplication/json

示例

{
  "code": "success",
  "message": "",
  "data": "task_img_01K5NYA1JK8R7X6C5V4B"
}

修改于 2026-09-24 01:30:16

提交异步生图任务

查询异步生图任务