OpenAI 图像编辑

Changed on Nov 3, 2026

接口说明：OpenAI Images API /v1/images/edits 的兼容端点（图生图）。请求、响应与错误格式完全遵循 OpenAI 规范：支持 application/json 与 multipart/form-data（可直接上传图片与遮罩文件），返回 OpenAI 原始 ImagesResponse，不使用 AiToEarn 通用响应包裹；图片链接为上游原始返回，不做转存。鉴权使用 Authorization: Bearer <API Key>（OpenAI SDK 默认携带），已有 OpenAI SDK 或生态工具只需替换 baseURL 与 API Key 即可接入，按 AiToEarn 积分计费。

模型取值来自「图像编辑模型」接口返回的 data[n].name。如需 AiToEarn 通用响应格式（code === 0）与转存后的稳定图片链接，请改用「编辑图像」接口。

post/api/ai/images/edits

Request

Base URL
https://aitoearn.cn
Auth
API key in header Authorization
TypeScript
https://skmtc.dev/aitoearn/apis/aitoearn-api/docs/api/ai/images/edits/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

modelstring required

图像编辑模型名称。先调用「图像编辑模型」接口（GET /api/ai/models/image/edit），传入其返回的 data[n].name；各模型支持的尺寸、最大输入图片数与价格以该接口返回为准。

promptstring required

提示词

maskstring

遮罩图片 URL，用于局部重绘（可选）。需为与 image 尺寸一致的 PNG 图片：完全透明（alpha 为 0）的区域表示需要按提示词重绘的部分，不透明区域保持原图不变。不传时对整张图片进行编辑。

ninteger

生成数量

sizestring

图像尺寸。可选值随模型而不同，以「图像编辑模型」接口返回的 data[n].sizes 为准；不同尺寸的价格不同，见 data[n].pricing。

response_format'url' | 'b64_json'

返回格式

Example request

{
  "model": "gpt-image-2",
  "image": "https://images.unsplash.com/photo-1592194996308-7b43878e84a6?auto=format&fit=crop&w=1024&q=80",
  "prompt": "Edit the provided image into a cozy realistic scene by placing the cute orange cat beside a sunlit window.",
  "n": 1,
  "size": "1024x1024",
  "response_format": "url"
}

Response

第三方协议原生响应或 SSE 数据。不使用 AiToEarn 通用响应包裹。

creatednumber

sizestring

Example response

{
  "data": [
    {
      "url": "string"
    }
  ],
  "created": "number",
  "size": "string",
  "usage": {
    "input_tokens": "number",
    "output_tokens": "number",
    "total_tokens": "number",
    "input_tokens_details": {
      "text_tokens": "number",
      "image_tokens": "number"
    },
    "output_tokens_details": {
      "text_tokens": "number",
      "image_tokens": "number"
    }
  }
}

Changes

Nov 3, 20267cc8f21c4c96 Revision changes
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: application/json)

Operation history