Images Edits

注意请求格式

此接口需要上传文件，因此必须使用 multipart/form-data 表单格式发起请求，请勿使用传统的 application/json 格式，否则会导致接口解析失败。

根据文本提示编辑图片，兼容 OpenAI Images Edits API。

请求

POST https://api.mirrorstages.com/openai/v1/images/edits

请求头

名称	类型	必填	说明
Authorization	string	是	Bearer your-api-key
Content-Type	string	是	multipart/form-data

请求体（Form Data）

参数	类型	必填	说明
model	string	是	模型名称，如 gpt-image-1
prompt	string	是	编辑描述文本
image	file	是	待编辑的原始图片文件
n	integer	否	生成图片数量，默认 1
response_format	string	否	返回格式，url 或 b64_json
stream	boolean	否	是否启用流式输出，默认 false

请求示例

curl -X POST https://api.mirrorstages.com/openai/v1/images/edits \
  -H "Authorization: Bearer your-api-key" \
  --form 'model=gpt-image-1' \
  --form 'prompt=Add a hat to the cat' \
  --form 'image=@"/path/to/image.png"' \
  --form 'n=1' \
  --form 'response_format=url'

响应

非流式响应

{
  "created": 1677858242,
  "data": [
    {
      "b64_json": "<base64-encoded-image>",
      "revised_prompt": "Add a hat to the cat"
    }
  ],
  "usage": {
    "total_tokens": 120,
    "input_tokens": 40,
    "output_tokens": 80,
    "input_tokens_details": {
      "text_tokens": 10,
      "image_tokens": 30
    }
  }
}

流式响应

当 stream: true 时，响应以 SSE 格式返回部分图片数据。