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

Gerar sua primeira imagem com a BetterToken exige uma única solicitação HTTP. Você precisa da sua própria API Key e de uma solicitação POST para https://www.bettertoken.ai/v1/images/generations. Defina o modelo como gpt-image-2 e envie uma descrição de texto no corpo da solicitação. A resposta retorna a imagem em b64_json, que você deve decodificar e salvar em um arquivo.

A BetterToken oferece uma Image API compatível com OpenAI, mas é um serviço independente: sua chave, saldo e histórico de solicitações pertencem à sua conta BetterToken, não à OpenAI. Antes de começar, crie uma chave no Dashboard BetterToken e confira as condições atuais na página de modelos e preços.

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

Pronto para executar a solicitação com sua própria chave? Crie uma conta BetterToken, obtenha uma API Key e mantenha-a fora do código-fonte. Criar uma conta BetterToken

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",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json",
    "output_format": "png"
  }' \
  -o image-response.json

Este é um contrato síncrono: a primeira solicitação mostrada não precisa de task ID, polling ou callback. Leia data[0].b64_json, decodifique-o e salve o PNG.

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.

Tamanhos, qualidade e formatos são parâmetros atuais: antes de uma segunda solicitação, escolha valores suportados nas Image API Docs atuais. Este contrato não confirma tarefas ou callbacks assíncronos, processamento em lote, templates para vendedores ou qualidade de imagem garantida.

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 e uma parte segura da resposta; tente de novo após uma espera. No BetterToken Dashboard, relacione a solicitação pelo horário e inspecione apenas modelo, status e cobrança real.

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.

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. Confira parâmetros e preços atuais antes de executar a solicitação.