Skip to main content

功能简介

通过 老张API 使用 OpenAI 标准的图像编辑 API,可以对现有图像进行局部编辑和修改。本文档详细介绍如何使用 Image Edit API 进行图像编辑。

概述

图像编辑 API 允许您通过提供原始图像、遮罩(mask)和文本提示词来编辑图像的特定部分。这个功能特别适用于:
  • 🎨 局部修改:只修改图像的特定区域
  • 🔄 内容替换:替换图像中的某些元素
  • 创意编辑:在保持整体风格的同时添加新元素
  • 🖼️ 图像修复:修复或改进图像的特定部分

API 工作原理

图像编辑需要三个关键要素:
  1. 原始图像:要编辑的基础图像
  2. 遮罩图像:指定要编辑的区域(透明部分将被编辑)
  3. 提示词:描述您想要在编辑区域生成的内容
遮罩图像中的透明区域(alpha 通道为 0)将被识别为需要编辑的部分。完全不透明的区域将保持不变。

快速开始

基础配置

基本编辑示例

API 参数详解

请求参数

响应格式

创建遮罩图像

使用 Python PIL 创建遮罩

使用圆形遮罩

完整使用示例

Python 完整示例

Node.js 示例

实际应用场景

1. 背景替换

2. 对象移除

3. 服装更换

4. 图像修复

高级技巧

1. 渐进式遮罩

创建具有羽化边缘的遮罩,使编辑更加自然:

2. 多区域编辑

同时编辑多个区域:

3. 智能提示词构建

最佳实践

1. 图像准备

  • 格式要求:确保图像是 PNG 格式
  • 尺寸要求:图像必须是正方形
  • 文件大小:小于 4MB
  • 分辨率建议:使用 1024x1024 获得最佳效果

2. 遮罩设计

  • 精确遮罩:遮罩越精确,编辑效果越好
  • 边缘处理:考虑使用羽化边缘使编辑更自然
  • 区域大小:避免编辑区域过大,可能影响效果

3. 提示词优化

4. 错误处理

常见问题

Q: 为什么编辑结果与预期不符?

A: 检查遮罩是否正确,确保透明区域准确覆盖要编辑的部分。同时优化提示词,提供更具体的描述。

Q: 支持哪些图像格式?

A: 目前仅支持 PNG 格式,且必须是正方形图像。

Q: 如何获得更自然的编辑效果?

A: 使用羽化遮罩,在提示词中强调”自然融合”、“匹配周围环境”等。

Q: 可以同时编辑多个区域吗?

A: 可以,价格在遮罩中标记多个透明区域即可。

Q: 编辑大型图像时有什么限制?

A: 图像文件必须小于 4MB,建议在上传前进行压缩。

相关资源

图像编辑 API 特别适合需要精确控制编辑区域的场景。通过合理设计遮罩和优化提示词,可以实现专业级的图像编辑效果。