图片编辑 Image Edit（单图/多图参考）

POST

https://api.mindcraft.com.cn/v1/images/edits

提示

headers 需要带上 "Bearer {{api_key}}" 进行验证
点击获取api_key

图片编辑 Image Edit

对参考图片进行修改编辑。兼容 OpenAI /v1/images/edits 格式，额外支持多图参考（最多 16 张）。

调用示例

单图 · base64

单图 · URL

多图 · base64

多图 · URL

请求参数

参数	类型	必填	说明
`model`	string	是	模型名称：`gpt-image-2`
`prompt`	string	是	编辑描述文本
`images`	string / string[]	是	参考图片。支持以下格式
`n`	integer	否	生成数量，默认 1
`size`	string	否	图片尺寸，如 `1024x1024`

`images` 参数格式

格式	示例	最大数量
base64 单图	`"images": "data:image/png;base64,iVBOR..."`	1
URL 单图	`"images": "https://example.com/photo.png"`	1
base64 多图	`"images": ["data:...", "data:..."]`	最多 16
URL 多图	`"images": ["https://...", "https://..."]`	最多 16

兼容性：同时支持 OpenAI /v1/images/edits 规范中的 image（单数）和 images（复数）字段名。

请求参数

Header 参数

Body 参数application/json

示例

{
    "model": "gpt-image-1",
    "prompt": "string",
    "images": [
        "string"
    ],
    "n": 0,
    "size": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.mindcraft.com.cn/v1/images/edits' \
--header 'Authorization: Bearer MC-你的APIKey' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-image-1",
    "prompt": "string",
    "images": [
        "string"
    ],
    "n": 0,
    "size": "string"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

修改于 2026-06-07 11:54:27

模型列表及参数获取

智谱文生视频

图片编辑 Image Edit（单图/多图参考）

图片编辑 Image Edit#

调用示例#

请求参数#

images 参数格式#

请求参数

请求示例代码

返回响应

图片编辑 Image Edit

调用示例

请求参数

`images` 参数格式