跳到主要内容

图片编辑

有一张参考图，想让彼源 AI 按描述改它——这一页帮你发出这个请求。

彼源 AI 支持 POST /v1/images/edits，完整端点是 https://api.biyuan.ai/v1/images/edits。图片编辑要用支持编辑的图片模型：先在模型广场的「图片」分类挑一个模型并复制它的名称（Model ID），替换下面的 <IMAGE_EDIT_MODEL>。想确认当前令牌实际可用的模型，调用 GET /v1/models（令牌设置了模型限制时，以这个返回为准）。

发一条请求​

把 <YOUR_TOKEN> 换成你的令牌（sk- 开头，在控制台令牌管理创建）。图片编辑用 multipart 表单同时上传参考图和修改说明：

curl https://api.biyuan.ai/v1/images/edits \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -F "model=<IMAGE_EDIT_MODEL>" \
  -F "image=@source-image.png" \
  -F "prompt=保留主体构图，把背景改成雨夜街头霓虹灯氛围，整体更有电影感" \
  -F "n=1"

用 curl -F 时不用手动设 Content-Type，curl 会自动带上 multipart 请求头。

看返回里的什么​

  • 平台读到了你的参考图（没有报文件错误）
  • 模型是按你的指令在改，而不是重画一张不相干的图
  • 结果落在 data[].url 或 data[].b64_json

参数与写法​

  • image：第一次用体积适中、格式常见的 PNG 或 JPEG，先排除文件损坏、路径错误和极端分辨率。
  • prompt：写清要保留什么、改变什么。「帮我改好看点」这类太宽泛，结果不稳。
  • n：先用 1，别把「请求问题」和「多结果挑选」混在一起。

一次只改 1 到 2 个重点（比如只换背景），比一口气换背景、换穿着、换构图更容易成功。

排错​

如果文生图能用、图片编辑不能用，先查这个模型是否在当前分组开放，而不是先怀疑令牌。看起来像「模型失败」时，多半是本地路径错误、文件损坏或 multipart 结构不对。图片编辑模型不能填进 TRAE、Cursor 这类聊天入口，原因见图片模型。

继续阅读​