GPT Image 2: sua primeira solicitação à Image API

O que você precisa

• curl para enviar a solicitação;
• sua própria API Key da BetterToken;
• a Base URL exata https://www.bettertoken.ai/v1;
• o modelo gpt-image-2 para esta Image API;
• um decodificador Base64 ou um script curto em Python.

Não coloque uma chave real no código-fonte, em capturas de tela ou em um comando que ficará no histórico do shell. Guarde-a em uma variável de ambiente:

export BETTERTOKEN_API_KEY="your_api_key_here"

O valor acima é apenas um marcador de posição. Use sua própria chave e nunca a publique.

Sua primeira solicitação GPT Image 2

Envie uma solicitação ao endpoint de geração de imagens:

curl https://www.bettertoken.ai/v1/images/generations \
  -H "Authorization: Bearer $BETTERTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean editorial illustration of a coding desk at night, green and graphite palette"
  }' \
  -o image-response.json

Se a solicitação for bem-sucedida, image-response.json conterá um objeto data. A imagem estará em data[0].b64_json. Esse formato de resposta funciona bem em fluxos do lado do servidor: você pode armazenar o payload em object storage, passá-lo à próxima etapa de processamento ou decodificá-lo diretamente em um arquivo local.

Salvando a imagem

O exemplo a seguir lê o JSON, decodifica o valor Base64 e cria bettertoken-image.png. Ele usa apenas a biblioteca padrão do Python:

import base64
import json

with open("image-response.json", "r", encoding="utf-8") as source:
    payload = json.load(source)

image_base64 = payload["data"][0]["b64_json"]

with open("bettertoken-image.png", "wb") as target:
    target.write(base64.b64decode(image_base64))

print("Saved: bettertoken-image.png")

Abra o arquivo e verifique se ele corresponde ao prompt. Um HTTP 200 confirma que a solicitação funcionou, mas não substitui a revisão visual do resultado.

Melhorando a segunda solicitação

Para o primeiro teste, use um prompt curto com quatro partes claras:

1. assunto ou cena;
2. estilo visual;
3. composição;
4. paleta ou iluminação.

Por exemplo:

Editorial illustration of a developer reviewing an API response,
clean geometric style, centered composition, dark graphite background
with restrained green accents, no text, no logos

Não comece com uma lista longa de exigências conflitantes. Primeiro confira a composição básica e depois altere apenas um parâmetro por vez. Assim fica mais fácil entender qual formulação afetou o resultado.

Erros comuns

401: chave rejeitada

Verifique se BETTERTOKEN_API_KEY está definida no terminal atual e se o cabeçalho de autorização inclui o prefixo Bearer. Não exiba a chave com echo nem envie o valor completo para o suporte.

402 ou saldo insuficiente

Abra o Dashboard BetterToken e verifique o saldo disponível. O saldo pago da BetterToken não é zerado automaticamente no fim do mês, mas toda solicitação ainda exige saldo restante suficiente.

404: caminho incorreto

A geração de imagens usa este caminho completo:

https://www.bettertoken.ai/v1/images/generations

Não o substitua pelo endpoint Chat Completions nem use api.openai.com: uma chave BetterToken funciona com o endpoint BetterToken.

400: modelo ou parâmetros incorretos

Comece apenas com os campos obrigatórios model e prompt. Este guia usa gpt-image-2. Se a API informar que o modelo está indisponível, compare o Model ID e os parâmetros atuais com a documentação da Image API.

429 ou 5xx

Não inicie um loop infinito de tentativas. Registre o status HTTP, o horário da solicitação e uma parte segura da resposta; depois tente novamente após uma espera. No Dashboard BetterToken, você pode relacionar a solicitação pelo horário e inspecionar o modelo, status, uso de tokens de entrada/saída/cache e a cobrança sem ver o prompt completo.

Verificações antes da integração em uma aplicação

Antes de levar a solicitação para um backend ou fluxo de automação, confirme que:

• a chave está guardada em uma variável de ambiente ou gerenciador de segredos;
• a solicitação vai para a BetterToken, não para o endpoint de outro provedor;
• o modelo e os parâmetros vêm da documentação atual;
• o payload Base64 é decodificado sem erros;
• a aplicação limita tentativas e trata respostas não 2xx;
• o custo é conferido na página atual de preços, e não em uma análise antiga.

Você pode então levar o mesmo contrato para o SDK ou cliente HTTP da sua aplicação. Comece pela solicitação mínima, salve um resultado e só então adicione dimensões, ajustes de qualidade, processamento em lote e sua própria camada de armazenamento.

Resumo rápido

O primeiro fluxo funcional tem três etapas: envie uma solicitação POST para a BetterToken Image API, leia data[0].b64_json e decodifique-o em um arquivo. Se precisar da sua própria chave e de cobrança por uso, crie uma conta BetterToken e confira parâmetros e preços atuais antes de executar a solicitação.