Pular para o conteúdo
Cheapest Imagen
Guias

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=url

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

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ção1 a 16
Tamanho de uma imagematé 20 MB
Tamanho da requisição inteiraaté 50 MB
Tipos de arquivoPNG, 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:

CampoO que fazValores
input_fidelityQuão fielmente o resultado mantém os detalhes das imagens de referêncialow (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: transparent retorna 400 em 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-adobe ou uma versão flare ou sunburst. Veja Proporções e tamanhos.

Nesta página