Como usar o GPT-Image-2 — pela API, e não pelo ChatGPT; quanto custa cada imagem

O GPT-Image-2（gpt-image 2）é o mais recente modelo de geração de imagens da OpenAI e pode ser usado de duas formas. Você pode pedir a imagem em texto no aplicativo do ChatGPT (dentro dos limites do plano do ChatGPT) ou chamar a API por imagem, com cobrança conforme o uso. Na API, via Kunavo, cada imagem custa $0.0633; basta trocar o base_url do SDK da OpenAI para https://api.kunavo.com/v1, especificar gpt-image-2 e chamar POST /v1/images/generations. Para editar imagens existentes, use gpt-image-2-edit com POST /v1/images/edits. O uso no ChatGPT e a cobrança da API são separados; os planos pagos do ChatGPT não incluem o uso da API.

Os resultados de busca em japonês são, em sua maioria, instruções para usar a interface do ChatGPT ou apresentações de sites externos que podem ser experimentados gratuitamente. Esta página cobre o que vem depois —o preço por imagem ao chamar a API, código que você pode copiar e executar imediatamente e o endpoint de edição — e também explica claramente quando o aplicativo do ChatGPT é mais adequado.

Usar o ChatGPT ou a API

Se você só cria algumas imagens ocasionalmente, o aplicativo do ChatGPT é mais simples. Não exige código nem chave, e você pode fazer ajustes na conversa, como pedir “deixe um pouco mais claro”. Como a OpenAI costuma alterar a quantidade de usos e as condições de cada plano, não incluí números aqui. A API se torna útil quando você cria dezenas ou centenas de imagens no mesmo formato, gera imagens dentro do seu próprio serviço ou quer conhecer o custo por imagem.

Como usar no ChatGPT (resumido)

Na caixa de chat do ChatGPT, basta pedir em texto a imagem que você deseja criar. Anexe uma imagem e peça “mude o fundo” para editá-la. Quanto mais especificamente você descrever a composição, a iluminação, o uso (banner, foto de produto etc.) e o texto que deve aparecer na imagem, mais o resultado se aproximará do que você quer. A mesma forma de escrever prompts também pode ser usada ao chamar a API.

Como usar a API — 3 etapas

1. Crie uma chave. Após o cadastro, em /app/keys emita uma chave que começa com sk-kn-. Ela só é exibida uma vez; salve-a imediatamente.
2. Adicione saldo.A partir de $10 no modelo pré-pago. No checkout da Stripe, você pode usar cartões, incluindo JCB, Apple Pay, Google Pay e Link. O saldo não expira.
3. Altere o destino do SDK da OpenAI e faça a chamada. Você não precisa de uma conta da OpenAI; no código existente, basta trocar base_url e a chave.

import os
import requests
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],   # sk-kn-...
    base_url="https://api.kunavo.com/v1",   # 既存コードから変えるのはここだけ
    timeout=600,                            # 同期モードは最長 540 秒待つ
)

img = client.images.generate(
    model="gpt-image-2",
    prompt="白い机の上の和菓子、やわらかい自然光、真上から、余白を多めに",
    size="1024x1024",                  # 縦横比として解釈される
    extra_body={"resolution": "2K"},   # 1K / 2K / 4K（SDK の標準外なので extra_body）
)

url = img.data[0].url   # 約 24 時間で消える一時 URL — すぐ保存する
with open("wagashi.png", "wb") as f:
    f.write(requests.get(url, timeout=60).content)

As URLs retornadas sãotemporárias e desaparecem em cerca de 24 horas; salve-as assim que forem recebidas, como no exemplo acima. A geração com GPT-Image-2 normalmente leva de 15 a 60 segundos, e no modo síncrono o Kunavo mantém a conexão por até 540 segundos. Configure o tempo limite do cliente para um valor maior. Para executar em grande volume, use a API assíncrona: envie com "async": true (ou webhook_url) e busque o resultado com GET /v1/images/{id}. Consulte a documentação da API de imagens para obter detalhes; do primeiro passo, a criação da chave, à primeira chamada, veja o início rápido.

Principais parâmetros

Preço do GPT-Image-2 — quanto custa cada imagem na API

Os preços abaixo são obtidos diretamente do catálogo de modelos deste site; se os preços mudarem, esta tabela também mudará.

Escolha 1K, 2K ou 4K: no momento, todas custam o mesmo, $0.0633 por imagem. Os preços por resolução são exibidos a partir do catálogo na seção de resoluções da documentação. A edição (GPT-Image-2 Edit) também custa $0.0633 por imagem. Solicitações com falha não são cobradas, mas uma imagem refeita por não ter ficado como você queria é uma geração bem-sucedida e, portanto, é cobrada por imagem.

O preço para usar diretamente a API da OpenAI está na página de preços da OpenAI. Ao comparar, use a mesma resolução e a mesma qualidade por imagem. O preço dos planos do ChatGPT é uma cobrança separada de ambas as APIs.

Editar imagens — gpt-image-2-edit

Para recriar uma imagem existente como base, use POST /v1/images/edits. Envie a imagem original em image como uma URL https ou uma URI base64 de data:; quando houver várias imagens de referência, envie um array em image_urls. A edição é enviada como JSON, por isso o exemplo usa requests.

import os
import base64
import requests

KEY = os.environ["KUNAVO_API_KEY"]

# 手元の画像を data: URI にする（https の URL をそのまま渡してもよい）
with open("wagashi.png", "rb") as f:
    src = "data:image/png;base64," + base64.b64encode(f.read()).decode()

r = requests.post(
    "https://api.kunavo.com/v1/images/edits",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
        "model": "gpt-image-2-edit",
        "prompt": "背景を藍色の和紙に変える。和菓子と構図はそのまま",
        "image": src,   # 参照画像が複数なら "image_urls": [...] に配列で
    },
    timeout=600,
)
print(r.json()["data"][0]["url"])

Se você reutiliza o mesmo arquivo muitas vezes, faça um upload uma vez com POST /v1/files e receba uma URL permanente em files.kunavo.com (até 25 MB). Depois, basta enviar essa URL em image.

Com transparência — quando o Kunavo não é a melhor opção

A API via Kunavo permite começar com uma única chave sem uma conta da OpenAI, mas funciona com capacidade compartilhada. Não há alocação dedicada (quota) nem SLA contratual. Se você precisa de quota garantida ou SLA em determinada escala, contrate diretamente com a OpenAI.

Além disso, se você só cria algumas imagens por mês conversando, o aplicativo do ChatGPT dá menos trabalho. Se nenhum dos motivos para escolher a API — “quantidade”, “integração” ou “controle de custos” — se aplica, o aplicativo é suficiente.

Quando usar o Nano Banana

Você pode chamar outros modelos de imagem usando a mesma chave e o mesmo endpoint; basta alterar a string em model. Se o volume for alto e o preço unitário for prioridade, use Nano Banana ($0.0273 por imagem); se a prioridade for seguir fielmente as instruções ou renderizar texto dentro da imagem, use o GPT-Image-2. Fazer 10 imagens com o mesmo prompt em cada um dos dois modelos é a maneira mais rápida de decidir.

A explicação detalhada em inglês está em guia da API do GPT-Image-2 e API do Nano Banana; os preços unitários dos modelos GPT de texto estão em preços da API GPT, a geração de vídeos está em como usar a API do Seedance e os preços de todos os modelos estão na página de preços.

Perguntas frequentes