词元 API 文档

Appearance

图片编辑 ​

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

请求地址 ​

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：账号或渠道正在限流、冷却。