Imagens

Edição de imagemns e imagens de referência

Forneça imagemns como base para um modelo de imagem: edite uma foto, coloque um produto em um novo cenário, mantenha o mesmo personagem entre cenas ou combine várias imagens em uma só.

Duas formas de enviar imagens

EndpointRecebeIdeal para
POST /v1/images/editsFormulário multipart da OpenAI (arquivos de imagem), ou JSONSDKs da OpenAI: client.images.edit(...)
POST /v1/images/generationsJSON com uma lista imagesQualquer cliente HTTP; imagens como links ou URLs de dados

Ambos aceitam os mesmos modelos, tamanhos e preços da geração. Uma edição custa o mesmo que uma nova imagem daquele tamanho.

Quantas imagens cada modelo aceita

ModeloIDTamanhos e preçosImagens de referência
Nano Banana 2.1nano-banana-2.11K $0.03 · 2K $0.04 · 4K $0.06até 14
Nano Banana Pronano-banana-pro1K e 2K $0.035 · 4K $0.065até 14
Nano Banana 2nano-banana-21K $0.025 · 2K $0.034 · 4K $0.058até 14
Nano Banana 2 Litenano-banana-2-lite1K $0.016até 14
GPT Image 2.5 Flaregpt-image-2.5-flare1K $0.028 · 2K $0.034 · 4K $0.045até 16
GPT Image 2.5 Sunburstgpt-image-2.5-sunburst1K $0.026 · 2K $0.034 · 4K $0.045até 16
GPT Image 2gpt-image-2$0.02 por imagematé 16
Grok Imagine Image 2.0grok-imagine-image-2.01K $0.045 · 2K $0.06até 3
FLUX 3 Imageflux-3-image1K $0.04 · 2K $0.05 · 4K $0.09até 1

Com os SDKs da OpenAI

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)

Como JSON

Em qualquer um dos endpoints, liste as imagens em images como links ou URLs de dados (image com uma imagem também funciona):

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())

Regras para imagens de entrada

  • PNG, JPEG ou WebP, até 20 MB cada.
  • Os links devem ser URLs https públicas; nós fazemos o download. Se não for possível baixar uma imagem, a solicitação será recusada com invalid_image antes de gerar qualquer coisa.
  • Faça referência às imagens pela ordem no prompt: “a primeira imagem”, “a segunda imagem”.
  • Máscaras não são compatíveis. Descreva a alteração (“substitua apenas o céu”); esses modelos editam apenas o que você indicar.
  • Se você exceder o limite de um modelo, a solicitação será recusada com um erro claro que informa o limite.

O que experimentar

ObjetivoModelo de prompt
Editar um elemento“Mude a cor do carro para preto fosco. Mantenha todo o resto igual.”
Novo fundo“Coloque a pessoa da imagem em uma praia ao pôr do sol, ajustando a iluminação.”
Produto em uma cena“Coloque o produto da primeira imagem na prateleira da segunda.”
Mesmo personagem, nova cena“A mesma mulher das referências, agora andando de bicicleta em Paris.”
Transferência de estilo“Redesenhe a primeira imagem no estilo da segunda.”
Combinar várias imagens“Uma foto em grupo das seis pessoas das imagens, em pé em uma escada.”

Tem dúvidas ou falta algo? Fale com nossa equipe de suporte e responderemos por e-mail, geralmente em até um minuto.