图片

图像编辑和参考图

为图片模型提供参考图片:编辑照片、将产品放入新场景、让角色在不同镜头中保持一致,或将多张图片合成为一张。

两种图片传入方式

端点支持输入适用场景
POST /v1/images/editsOpenAI 的 multipart 表单(图片文件),或 JSONOpenAI SDK:client.images.edit(...)
POST /v1/images/generations包含 images 列表的 JSON任意 HTTP 客户端;图片通过链接或 data URL 传入

两种方式支持的模型、尺寸和价格均与图片生成相同。编辑图片与生成同尺寸新图片的费用相同。

各模型支持的参考图片数量

模型ID尺寸与价格参考图
Nano Banana 2.1nano-banana-2.11K $0.03 · 2K $0.04 · 4K $0.06最多 14
Nano Banana Pronano-banana-pro1K 和 2K $0.035 · 4K $0.065最多 14
Nano Banana 2nano-banana-21K $0.025 · 2K $0.034 · 4K $0.058最多 14
Nano Banana 2 Litenano-banana-2-lite1K $0.016最多 14
GPT Image 2.5 Flaregpt-image-2.5-flare1K $0.028 · 2K $0.034 · 4K $0.045最多 16
GPT Image 2.5 Sunburstgpt-image-2.5-sunburst1K $0.026 · 2K $0.034 · 4K $0.045最多 16
GPT Image 2gpt-image-2每张 $0.02最多 16
Grok Imagine Image 2.0grok-imagine-image-2.01K $0.045 · 2K $0.06最多 3
FLUX 3 Imageflux-3-image1K $0.04 · 2K $0.05 · 4K $0.09最多 1

使用 OpenAI SDK

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.zurelay.com/v1", api_key=os.environ["ZURELAY_API_KEY"])
result = client.images.edit(
model="gpt-image-2",
image=[open("product.png", "rb"), open("background.jpg", "rb")],
prompt="Put the bottle from the first image on the marble counter in the second. Keep its label exactly.",
)
print(result.data[0].url)

使用 JSON

无论使用哪个端点,都可以在 images 中以链接或 data URL 的形式列出图片(只有一张图片时,也可以用 image):

import os
import requests
response = requests.post(
"https://api.zurelay.com/v1/images/generations",
headers={"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"},
json={
"model": "nano-banana-pro",
"prompt": "Make the jacket in the first image deep green, and give the model the pose from the second.",
"images": [
"https://example.com/model.jpg",
"data:image/png;base64,iVBORw0KGgo..."
],
"size": "2K",
"aspect_ratio": "4:5"
},
)
response.raise_for_status()
print(response.json())

输入图片规则

  • PNG、JPEG 或 WebP,每张最大 20 MB。
  • 链接必须是可公开访问的 https URL;我们会自行下载图片。如果下载失败,会在生成任何内容之前返回 invalid_image 并拒绝请求。
  • 在提示词中按顺序引用图片:“第一张图片”、“第二张图片”。
  • 不支持蒙版。请直接描述要做的修改(“只替换天空”);这些模型只会修改你指定的内容。
  • 超出模型限制时,请求会被拒绝,并返回明确说明限制的错误。

试试这些用法

目标提示词示例
局部修改“将汽车改成哑光黑色。其他所有内容保持不变。”
更换背景“将图片中的人物放在日落时分的海滩上,并让光照与场景一致。”
将产品融入场景“将第一张图片中的产品放在第二张图片的架子上。”
同一角色,全新镜头“参考图中的同一位女性,现在正在巴黎骑自行车。”
风格迁移“用第二张图片的风格重绘第一张图片。”
多图合成“让图片中的六个人站在楼梯上,拍一张合照。”

有疑问,或发现内容缺失?联系我们的支持团队,我们会通过邮件回复,通常只需一分钟。