支持输入图片
根据后端流程和所选模型，使用图片 URL 或 base64 data URL 作为编辑输入。
AI 图片编辑 API
面向产品工作流的 AI 图片编辑 API
通过一个 API 转换参考图、生成商品图变体、修改风格和搭建编辑功能，支持 Gemini 与 GPT 图片模型路线。
参考图输入提示词编辑多输出流程
图片编辑请求
向支持编辑的模型发送输入图片和提示词指令。
curl https://api.pixapi.ai/v1/images/edits \
-H "Authorization: Bearer $PIXAPI_KEY" \
-F "model=gemini-3-pro-image-preview" \
-F "image=@product.png" \
-F "prompt=Place the product in a clean studio scene" \
-F "n=1" \
-F "size=1024x1024"直接答案：Pixapi 图片编辑 API 如何工作
Pixapi 图片编辑同步请求使用 POST /v1/images/edits；需要任务式处理时使用 POST /v1/async/images/edits。
编辑请求应从服务端发起，通过 multipart 表单提交 model、image、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 密钥暴露到浏览器。 |
可靠的 AI 图片编辑 API 应该覆盖什么
AI 图片编辑 API 需要处理用户上传、参考图、提示词指令、输出追踪和成本控制。Pixapi 把 AI 图片编辑 API 当作生产工作流，而不是一次性演示。
稳定的 AI 图片编辑 API 首先要有可预测输入。产品可能发送商品图、用户上传参考图、风格说明或另一条流程生成的图片。AI 图片编辑 API 应该用明确格式接收这些输入，将请求留在服务端，并返回应用可保存的输出。
许多团队采用 AI 图片编辑 API，是因为已经有背景替换、商品图清理、广告变体、风格迁移或视觉个性化工作流。这时 AI 图片编辑 API 既要让工程师容易接入，也要让设计团队有足够灵活度。Pixapi 通过模型页和示例，让团队判断 Gemini 图片编辑还是 GPT 图片路线更合适。
AI 图片编辑 API 会接触客户素材，因此运营层很重要。上传校验、密钥管理、请求日志和失败处理，都应该围绕 AI 图片编辑 API 提前建立。Pixapi 鼓励后端调用、记录 request id，并用额度账本追踪用量。
当 AI 图片编辑 API 与图片生成共用同一套额度系统时，定价也更容易说明。产品团队可以在开放功能前估算商品图编辑、批量背景处理或活动素材生成的成本。清晰的 AI 图片编辑 API 定价，有助于决定免费额度、付费门槛和高频使用限制。
实用的 AI 图片编辑 API 还应该把编辑意图连接到相邻页面。进入 AI 图片编辑 API 页面的人，通常还会查看图片生成、模型对比、价格和文档。Pixapi 将 AI 图片编辑 API 旅程连接到模型目录、图片生成 API 页面和 API 文档。
当产品需要可重复的图片转换，而不是手工修图时，就适合使用 AI 图片编辑 API。Pixapi 让 AI 图片编辑 API 服务 SaaS 控制台、电商工具、内部创意流水线和用户上传流程，同时让你的 UI 决定预览、审核、历史记录和权限边界。
图片编辑 API 常见问题
Pixapi 可以编辑已有图片吗？
可以。支持的图片模型能通过图片编辑接口接收输入图片和提示词指令。
图片编辑如何计费？
编辑会根据所选模型和输出设置消耗额度，当前成本以模型页和价格页为准。
可以一次生成多个编辑结果吗？
支持的路由可以返回多个输出，请参考所选模型文档中的输出数量参数。
上传图片应该在哪里处理？
建议在你的后端或可信存储层处理上传，再把验证后的图片 URL 或 data URL 传给 Pixapi。