Skip to main content
POST
/
v1
/
images
/
edits
cURL
curl https://api.deerapi.com/v1/images/edits \
  -H "Authorization: Bearer <DEERAPI_KEY>" \
  -F "model=doubao-seededit-3-0-i2i-250628" \
  -F "image=@input.png" \
  -F "prompt=把背景改成浅蓝色，并保留主体轮廓" \
  -F "response_format=url" \
  -F "watermark=false"
{
  "created": 1773296963,
  "data": [
    {
      "url": "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/example/edited.jpeg"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 16384,
    "output_tokens": 16384,
    "prompt_tokens_details": {
      "cached_tokens_details": {}
    },
    "completion_tokens_details": {},
    "claude_cache_creation_5_m_tokens": 0,
    "claude_cache_creation_1_h_tokens": 0
  }
}
如果你已经有一张本地图片，只想用自然语言把它改掉，当前页是最直接的入口。

​
当前页适合哪种任务

  • 上传一张图，然后告诉模型“改哪里、怎么改”。
  • 只处理单图，不需要异步任务对象。
  • 想复用 OpenAI 风格客户端的图片编辑心智模型。

​
第一次编辑建议这样做

1

先准备一张本地图

当前页走 multipart/form-data 上传，第一次调试建议直接用本地 png 或 jpeg 文件。
2

prompt 只写变更点

先写“把背景改成浅蓝色，并保留主体轮廓”这类清晰指令，不要一开始就把整张图重写。
3

先用 url 返回

response_format=url 最方便快速验证编辑结果。等链路稳定后，再考虑 b64_json。
4

需要可复现时再固定 seed

默认 seed=-1 代表随机。只有你明确想复现同一版结果时，再把 seed 固定下来。
当前只支持单张输入图。宽高比需在 (1/3, 3) 内，文件大小不超过 10MB。

​
和 Seedream 的分工别混了

你的需求该去哪一页
改一张现有图片当前页
纯文本生图、多图融合、组图返回Seedream
带状态查询的异步任务流FLUX / Replicate 风格页面

​
与火山方舟的关系

  • 火山方舟官方把 Seededit 放在图片生成体系里，通过模型 ID 区分。
  • DeerAPI 额外提供了 POST /v1/images/edits，更贴近 OpenAI 风格图片编辑调用方式。
  • DeerAPI 只暴露当前已经接入的 doubao-seededit-3-0-i2i-250628，不会自动跟随官方暴露所有历史编辑模型。

​
参考文档

Authorizations

​
Authorization
string
header
required

使用 DeerAPI Key 进行 Bearer Token 鉴权。

Body

multipart/form-data
​
model
enum<string>
required

当前可用的 Seededit 模型 ID。

Available options:
doubao-seededit-3-0-i2i-250628
​
image
file
required

待编辑的输入图片文件。建议使用 jpeg 或 png；宽高比需在 (1/3, 3) 内，单文件不超过 10MB。

​
prompt
string
required

编辑指令，例如“把背景改成浅蓝色，并保留主体轮廓”。

​
response_format
enum<string>
default:url

图片返回方式。url 返回图片链接，b64_json 返回 Base64 字符串。

Available options:
url,
b64_json
​
size
string

输出尺寸。该模型通常按输入图自适应处理，第一次调用时可以不传。

​
seed
integer
default:-1

随机种子。固定同样的参数与种子可以提升结果的可复现性。

Required range: -1 <= x <= 2147483647
​
guidance_scale
number
default:5.5

文本编辑指令的影响强度。值越大，模型越倾向于严格遵守 prompt。

Required range: 1 <= x <= 10
​
watermark
boolean
default:true

是否添加 AI 生成水印。

Response

200 - application/json

编辑成功

​
created
integer
required
​
data
object[]
required
​
usage
object
required
​
model
string
​
error
object