词元 API 文档

Appearance

图片编辑 ​

图片编辑接口通常使用 multipart/form-data，图片文件用表单字段传入。

图片编辑同样支持异步模式。提交时增加 Prefer: respond-async，任务查询仍统一使用 /v1/images/generations/{task_id}，详见异步生图。

请求地址 ​

http
POST /v1/images/edits

curl 示例 ​

bash
curl https://code.ciyuanapi.xyz/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=gpt-image-2" \
  -F "image=@./input.png" \
  -F "prompt=把背景换成干净的白色摄影棚，主体保持不变" \
  -F "size=1024x1024"

URL 图片 ​

如果你的上游或代理支持 URL 输入，可以传图片 URL；如果报参数错误，就先下载成文件再用 -F "image=@文件路径" 上传。

常见错误 ​

  • Model name not specified：表单里没有传 model，或字段名填错。
  • 400：图片格式、大小或表单字段不符合要求。
  • 429：账号或渠道正在限流、冷却。

异步编辑注意事项 ​

  • 请求体仍为 multipart/form-data，图片文件和其他字段的传法不变。
  • 不要查询 /v1/images/edits/{task_id}，该路由不存在。
  • 完成后的图片链接为临时地址，请在 6 小时内下载保存。