Editar imagens
Imagem para imagem com a API do Cheapest Imagen. Envie imagens de referência para /v1/images/edits com GPT Image ou Nano Banana, como arquivos ou links.
Envie um prompt e uma ou mais imagens de referência para POST /v1/images/edits. Todos os modelos aceitam imagens de referência, e uma edição custa os mesmos créditos de uma imagem nova.
Enviar arquivos
Envie a requisição como formulário. Repita image[] para cada imagem de referência.
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-F model=nano-banana-2.1 \
-F prompt="put the product on a marble table, soft daylight" \
-F "image[]=@product-front.png" \
-F "image[]=@product-side.png" \
-F size=2048x2048 \
-F response_format=urlCom o SDK da OpenAI:
from openai import OpenAI
client = OpenAI(base_url="https://api.cheapestimagen.com/v1", api_key="YOUR_KEY")
result = client.images.edit(
model="gpt-image-2.6",
image=[open("portrait.png", "rb")],
prompt="change the jacket to dark green, keep the face and the background",
response_format="url",
)
print(result.data[0].url)Enviar links em vez de arquivos
Envie JSON com um array images. Cada item tem um image_url, que é um link https: ou uma URL data: em base64.
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"prompt": "turn this sketch into a watercolour illustration",
"images": [{ "image_url": "https://example.com/sketch.png" }]
}'file_id não é aceito; passe image_url.
Limites
| Imagens de referência por requisição | 1 a 16 |
| Tamanho de uma imagem | até 20 MB |
| Tamanho da requisição inteira | até 50 MB |
| Tipos de arquivo | PNG, JPEG, WebP |
Uma requisição acima desses limites retorna 413.
Opções
Toda opção de texto para imagem funciona nas edições: n, size, quality, output_format, response_format. Mais uma é só para edições:
| Campo | O que faz | Valores |
|---|---|---|
input_fidelity | Quão fielmente o resultado mantém os detalhes das imagens de referência | low (padrão), high. Funciona no GPT Image 2.5 e 2.6 e nas versões flare e sunburst; os outros modelos retornam 400 |
O que não é aceito
- Máscaras. Não é possível repintar só uma área. Descreva no prompt o que deve continuar igual.
- Fundos transparentes.
background: transparentretorna400em todos os modelos.
Dicas
- Envie mais de um ângulo do objeto quando ele precisar continuar igual.
- Diga o que não deve mudar: “mantenha o rótulo sem alterações”, “mesmo rosto e mesmo penteado”.
- Para saída em 2K e 4K, use o Nano Banana, o
gpt-image-2-adobeou uma versão flare ou sunburst. Veja Proporções e tamanhos.
Modelos
Todos os ids de modelo da API do Cheapest Imagen, com o modelo oficial da OpenAI ou do Google que cada um executa, as resoluções que gera e os créditos por imagem.
Proporções e tamanhos
Os tamanhos de imagem que você pode passar no campo size da API do Cheapest Imagen: até 19 proporções em 1K, 2K e 4K, e tamanhos personalizados.