跳转到主要内容
POST
/
v1
/
images
/
edits
cURL
curl --request POST \
  --url https://proxy.innk.cc/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'image=<string>' \
  --form 'prompt=<string>' \
  --form mask='@example-file' \
  --form model=gpt-image-1 \
  --form quality=auto \
  --form response_format=url \
  --form size=1024x1024 \
  --form image.items='@example-file'
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123,
    "prompt_tokens_details": {
      "cached_tokens": 123,
      "audio_tokens": 123
    },
    "completion_tokens_details": {
      "reasoning_tokens": 123,
      "audio_tokens": 123,
      "accepted_prediction_tokens": 123,
      "rejected_prediction_tokens": 123
    }
  }
}
不同模型的参数兼容可能不同,如有疑问请联系客服。

Authorizations

Authorization
string
header
required

身份验证标头格式为 Bearer <API_KEY>,其中 <API_KEY> 是您的API令牌。

Body

multipart/form-data
image
file[]
required

要编辑的图片。必须是受支持的图片文件或图片数组。对于gpt-image-1,每张图片应为小于25MB的png、webp或jpg文件。对于dall-e-2,您只能提供一张图片,并且该图片应为小于4MB的方形png文件。

prompt
string
required

所需图像的文本描述。dall-e-2的最大长度为1000个字符,gpt-image-1的最大长度为32000个字符。

mask
file

一张附加图片,其完全透明区域(例如,alpha值为零)指示应编辑image位置。如果提供了多张图片,则遮罩将应用于第一张图片。必须是有效的PNG文件,小于4MB,且尺寸与image相同。

model
string
default:gpt-image-1

用于生成图像的模型。仅支持dall-e-2和gpt-image-1。除非使用特定于gpt-image-1参数,否则默认为dall-e-2。

quality
enum<string>
default:auto

生成图像的质量。只有gpt-image-1支持high、medium和low质量。dall-e-2仅支持standard质量。默认为auto。

可用选项:
auto,
high,
medium,
low,
standard
response_format
enum<string>
default:url

返回生成图像的格式。必须是url或b64_json之一。URL在图像生成后60分钟内有效。此参数仅适用于dall-e-2,因为gpt-image-1始终返回base64编码的图像。

可用选项:
url,
b64_json
size
enum<string>
default:1024x1024

生成图像的尺寸。对于gpt-image-1,必须为1024x1024、1536x1024(横向)、1024x1536(纵向)或auto(默认值)之一;对于dall-e-2,必须为256x256、512x512或1024x1024之一。

可用选项:
auto,
1024x1024,
1536x1024,
1024x1536,
256x256,
512x512

Response

200 - application/json

Image edit response

created
integer
required

图像创建的 Unix 时间戳(以秒为单位)。

data
object[]
required

生成的图像列表

usage
object

用量