跳到正文
土土金API

API 参考

图像编辑 Images Edits

POST /v1/images/edits 的参数与示例:上传原图加提示词修改图片,支持多图合成和蒙版局部重绘。multipart/form-data 格式,与 OpenAI 图像编辑接口一致,本站按原格式转发请求。

POST /v1/images/edits 在一张或多张原图的基础上,按提示词生成新图片。常见用法是换背景、改画面里的文字、局部重绘,或者把商品图和 logo 合成到一起。请求用 multipart/form-data 上传文件,格式与 OpenAI Images API 一致。本站把请求按原格式转发给模型服务,不同模型支持的字段和取值不同,以对应模型的官方说明为准。

POSThttps://www.tutujin.com/v1/images/edits

请求头

请求头必填说明
Authorization是Bearer sk-...,控制台创建的 API Key
Content-Type是multipart/form-data。用 SDK 或 curl -F 时会自动设置并带上 boundary,不要手写

请求参数

参数类型必填说明
modelstring是模型名,例如 gpt-image-1.5
imagefile是原图,常见格式 PNG、JPEG、WEBP。GPT Image 系列可以传多张,表单字段名写成 image[]
promptstring是修改要求,说明要改什么、哪些地方保持不变
maskfile否蒙版 PNG。透明区域(alpha 为 0)是要重绘的位置,尺寸要和原图一致,作用于第一张原图
ninteger否生成几张,默认 1
sizestring否输出尺寸,可选值因模型而异
qualitystring否GPT Image 系列可选 low、medium、high、auto
response_formatstring否url 或 b64_json,部分模型只支持其中一种

请求示例

下面的例子把 logo 印到杯身上,cup.png 是商品图,logo.png 是 logo:

curl https://www.tutujin.com/v1/images/edits \
  -H "Authorization: Bearer $TUTUJIN_API_KEY" \
  -F model="gpt-image-1.5" \
  -F "image[]=@cup.png" \
  -F "image[]=@logo.png" \
  -F prompt="把第二张图的 logo 印在杯身正面,保持杯子形状、颜色和光线不变"

用蒙版局部重绘

只想改画面的一部分时,再上传一张和原图同尺寸的 PNG 蒙版,把要重绘的区域做成透明:

cURL
curl https://www.tutujin.com/v1/images/edits \
  -H "Authorization: Bearer $TUTUJIN_API_KEY" \
  -F model="gpt-image-1.5" \
  -F "image[]=@room.png" \
  -F mask=@mask.png \
  -F prompt="在透明区域放一盆绿植,风格和光线与房间一致"

响应示例

JSON
{
  "created": 1794000000,
  "data": [
    { "b64_json": "iVBORw0KGgo..." }
  ]
}
字段说明
data[].b64_jsonbase64 编码的图片数据
data[].url图片的临时链接,模型返回链接时出现,会过期
usage按 token 计费的图像模型会返回输入、输出 tokens,原图也计入输入

注意事项

  • 这个接口是原样转发,没有在本站单独实测。GPT Image 以外的模型对字段名、多图写法的要求可能不同,接入前先用一两次请求确认。
  • 上传文件的后缀要和真实格式一致,例如 cup.png 必须真的是 PNG,否则可能报错或出图异常。
  • 原图越大,请求越慢,也可能触发请求体过大(413)。发送前把图片缩到够用的尺寸。
  • 返回的链接是临时地址,下载后转存到自己的存储。
  • 生图耗时较长,客户端超时建议设为 300 秒左右。实际扣费以控制台「操作日志」为准。

支持此接口的模型

模型厂商最低价分组输入 ¥/百万输出 ¥/百万按次 ¥/次
nano-banana-proGoogle标准——¥0.4
fluxFlux 绘图标准——¥0.02
flux-schnellFlux 绘图标准——¥0.02
flux-devFlux 绘图标准——¥0.06
gpt-4o-imageOpenAI标准——¥0.1
flux-proFlux 绘图标准——¥0.1
grok-imagine-image-2.0xAI标准——¥0.12
gpt-image-1.5OpenAI标准——¥0.12

价格为人民币,取各模型最低价分组;价格更新于 2026年11月13日 01:33。

共 31 个模型支持此接口,上表列出其中一部分。 在模型广场查看全部

没找到答案?加客服微信 JsnonoChat,发送报错信息里的 request id,我们帮你排查。