创建图像编辑

使用本接口编辑输入图片。接口格式与 OpenAI edits  协议兼容。

授权

Authorization

• 类型：HTTP Bearer Auth，值类型 string
• 必填
• 说明：用于验证账户信息。前往 API 控制台 ，点击创建令牌获取。

Authorization: Bearer <YOUR_API_KEY>

请求头

Content-Type

• 类型：enum<string>
• 必填，固定值 multipart/form-data
• 说明：请求体的媒体类型。图片文件以表单形式上传，必须为 multipart/form-data，客户端 SDK 通常会自动设置。

请求体

概览

model

• 类型：string
• 必填
• 说明：要使用的图像编辑模型。
• 可选值：
  • Ming-Image-0.1-Design — 支持通用图片编辑。
  • Ming-Image-0.1-Design-Layer — 仅支持图层解耦。

image

• 类型：file[]
• 必填
• 说明：输入图片列表，支持 1 N 张图片。该字段在 form-data 中使用 image[] 传递。

prompt

• 类型：string
• 必填
• 说明：用于描述目标编辑效果。使用 Ming-Image-0.1-Design-Layer 时，该描述用于引导图层解耦，例如 "分三层"。

output_format

• 类型：string
• 选填，默认 png
• 说明：生成图像的输出格式。
• 可选值：png、jpeg、webp

response_format

• 类型：string
• 选填，默认 b64_json
• 说明：返回图片的形式。
• 可选值：
  • url — 返回图片 URL，有效期 24 小时。
  • b64_json — 返回图片 Base64 编码数据。

size

• 类型：string
• 选填，默认 auto
• 说明：输出图像大小。设为 auto 时由模型自动选择；也可以使用 {w}x{h} 格式指定，例如 "512x512"。

watermark

• 类型：boolean
• 选填，默认 false
• 说明：控制 AI 生成图片时是否添加水印。
• 可选值：
  • true — 启用 AI 生成的显式水印及隐式数字水印，符合政策要求。
  • false — 关闭所有水印。

不支持的属性

以下 OpenAI images/edits 的属性，当前接口不支持：

• background
• n
• input_fidelity
• output_compression
• partial_images
• quality
• stream

响应体

created

• 类型：integer
• 说明：响应生成时间，Unix 时间戳，单位为秒。

id

• 类型：string
• 说明：本次请求的唯一标识。

model

• 类型：string
• 说明：本次请求使用的模型 ID。

data

• 类型：object[]
• 说明：编辑后的图片列表。

data[].b64_json

• 类型：string
• 说明：当 response_format 为 b64_json 时，返回图片的 Base64 编码数据。

data[].url

• 类型：string
• 说明：当 response_format 为 url 时，返回图片 URL，有效期 24 小时。

data[].revised_prompt

• 类型：string
• 选填
• 说明：模型整理或补充后的图片描述。

usage

• 类型：object
• 说明：本次请求的 Token 与图片张数统计。图片按张数计费时，以 input_image_count 和 output_image_count 为准。

usage.input_tokens

• 类型：integer
• 说明：消耗的输入 Token 数，包含输入图片与文本 Token。

usage.input_tokens_details

• 类型：object
• 说明：输入 Token 明细。
• 字段：
  • image_tokens — 图像输入消耗的 Token 数。
  • text_tokens — 文本输入消耗的 Token 数。

usage.output_tokens

• 类型：integer
• 说明：生成的输出 Token 数。

usage.output_tokens_details

• 类型：object
• 说明：输出 Token 明细。
• 字段：
  • image_tokens — 图像生成消耗的 Token 数。
  • text_tokens — 文本生成消耗的 Token 数。

usage.total_tokens

• 类型：integer
• 说明：消耗的总 Token 数。

usage.input_image_count

• 类型：integer
• 说明：本次请求的输入图片张数，等于 image[] 中上传的图片数量。

usage.output_image_count

• 类型：integer
• 说明：本次请求生成的输出图片张数，按张计费时使用该值。

示例

请求示例

curl --location --request POST \
  'https://api.ant-ling.com/v1/images/edits' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --form 'model="Ming-Image-0.1-Design-Layer"' \
  --form 'prompt="分三层"' \
  --form 'image[]=@"/Users/xiaolong/Desktop/diary/image.png"' \
  --form 'size="1024x1024"'

from openai import OpenAI
 
client = OpenAI(
    base_url="https://api.ant-ling.com/v1",
    api_key="<YOUR_API_KEY>"
)
 
response = client.images.edit(
    model="Ming-Image-0.1-Design-Layer",
    prompt="分三层",
    image=[open("/path/to/image.png", "rb")],
    size="1024x1024"
)
 
print(response.data[0].b64_json)

import OpenAI from 'openai';
import fs from 'fs';
 
const client = new OpenAI({
  baseURL: 'https://api.ant-ling.com/v1',
  apiKey: '<YOUR_API_KEY>',
});
 
const response = await client.images.edit({
  model: 'Ming-Image-0.1-Design-Layer',
  prompt: '分三层',
  image: [fs.createReadStream('/path/to/image.png')],
  size: '1024x1024',
});
 
console.log(response.data[0].b64_json);

响应示例

{
  "created": 1713833628,
  "id": "0b446a1717930916439978967edcf9",
  "model": "Ming-Image-0.1-Design-Layer",
  "data": [
    {
      "b64_json": "...",
      "revised_prompt": "..."
    }
  ],
  "usage": {
    "input_tokens": 0,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 0
    },
    "output_tokens": 4096,
    "output_tokens_details": {
      "image_tokens": 4096,
      "text_tokens": 0
    },
    "total_tokens": 4096,
    "input_image_count": 1,
    "output_image_count": 1
  }
}