支持输入图片
在 JSON 的 image 字段中使用托管图片 URL 作为编辑输入。
AI 图片编辑 API
面向产品工作流的 AI 图片编辑 API
通过一个 API 转换参考图、生成商品图变体、修改风格和搭建编辑功能，支持 Gemini 与 GPT 图片模型路线。
参考图输入提示词编辑多输出流程
图片编辑请求
向支持编辑的模型发送输入图片和提示词指令。
curl https://api.pixapi.ai/v1/images/edits \
-H "Authorization: Bearer $PIXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-pro-image-preview",
"image": "https://cdn.example.com/product.png",
"prompt": "Place the product in a clean studio scene",
"n": 1,
"size": "1:1"
}'直接答案：Pixapi 图片编辑 API 如何工作
Pixapi 图片编辑同步请求使用 POST /v1/images/edits；需要任务式处理时使用 POST /v1/async/images/edits。
编辑请求应从服务端发起，通过 JSON 提交 model、image URL、prompt、n、size 等字段，并调用支持编辑的图片模型。
适合背景替换、商品图变体、参考图编辑和用户上传流程；应用应保存 request id、model id 和额度消耗记录。
不再为每个供应商写图片编辑胶水代码
图片编辑比一次性生成更依赖请求校验、素材处理、重试和清晰计费。
提示词控制编辑
构建商品摄影、背景替换、风格迁移和创意变体等工作流。
统一额度账本
生成和编辑共用同一套计费模型，便于产品团队预测视觉 AI 成本。
生产可观测性
记录 request id 和 model id，方便排查失败或被拒绝的编辑任务。
模型 fallback 策略
对比 Gemini 和 GPT 图片路线，同时保持外围 API 协议熟悉稳定。
安全优先接入
把用户上传处理和 Pixapi 密钥留在服务端，不暴露供应商凭证。
图片编辑使用场景
| 工作流 | Pixapi 模型路由 | 实现建议 |
|---|---|---|
| 替换背景 | Gemini 图片编辑 | 发送源图和简洁场景提示词。 |
| 商品图变体 | Gemini 或 GPT 图片路由 | 保存 request id 和模型 id 便于排查。 |
| 创意尺寸扩展 | 图片生成或编辑路由 | 按投放渠道选择比例和输出数量。 |
| 用户上传编辑 | 后端调用 Pixapi | 校验文件，不把 API 密钥暴露到浏览器。 |
图片编辑 API 常见问题
Pixapi 可以编辑已有图片吗？
可以。支持的图片模型能通过图片编辑接口接收输入图片和提示词指令。
图片编辑如何计费？
编辑会根据所选模型和输出设置消耗额度，当前成本以模型页和价格页为准。
可以一次生成多个编辑结果吗？
支持的路由可以返回多个输出，请参考所选模型文档中的输出数量参数。
上传图片应该在哪里处理？
建议在你的后端或可信存储层处理上传，再把验证后的托管图片 URL 传给 Pixapi。