Skip to main content
POST
cURL
POST /v1/images/generations O endpoint de texto para imagem usa um corpo de solicitação application/json. Envie um prompt, mantenha a solicitação HTTP aberta e leia a imagem gerada em data[0].b64_json na mesma resposta.
Use https://bettertoken.ai/v1 como Base URL. Passe sua BetterToken API Key por Authorization: Bearer YOUR_API_KEY.
Você pode informar Authorization e o corpo da solicitação no Playground à direita da página e enviar a solicitação diretamente para https://bettertoken.ai/v1/images/generations.
Não coloque API Keys no código de frontend do navegador, em repositórios Git, tickets, capturas de tela ou logs. Para chamadas por proxy no servidor, armazene API Keys somente em variáveis de ambiente do servidor ou em um gerenciador de segredos.

Escolha o fluxo correto

  • Gerar uma imagem a partir de texto e salvar o resultado: permaneça nesta página. Comece pelo exemplo de curl e depois use Salvar a imagem para decodificar data[0].b64_json.
  • Editar uma imagem existente: use Image to image, que envia um ou mais arquivos de origem como multipart/form-data.
  • Escolher um modelo, revisar parâmetros e estimar o orçamento: consulte os Model IDs e preços atuais na model plaza e use Valores recomendados abaixo para os parâmetros. O artigo em inglês sobre a primeira solicitação do GPT Image 2 traz o contexto completo da solicitação e da resposta.

Início rápido com curl

Use https://bettertoken.ai/v1 como Base URL e envie uma solicitação para https://bettertoken.ai/v1/images/generations:

Valores recomendados

Envie estes campos explicitamente em cada solicitação:
Gere várias imagens enviando várias solicitações independentes. Não dependa de uma única solicitação com n > 1.

Tamanhos recomendados

size representa a proporção e a faixa de tamanho esperadas. Os pixels retornados podem ser mapeados ou ajustados pelo servidor. Use as dimensões da imagem decodificada em vez de recortar à força a saída para o valor solicitado.

Salve a imagem

Uma resposta bem-sucedida segue o formato de resposta de imagem compatível com OpenAI:
Leia data[0].b64_json e salve-o como conteúdo de imagem base64. A resposta pode incluir campos extras, como revised_prompt; permita esses campos no cliente. Defina sempre output_format: "png". Depois salve a imagem decodificada como .png, sem inspecionar cabeçalhos de arquivo.

Exemplo JavaScript (Node.js)

Não dependa de output_format: "jpeg" ou output_format: "webp" para receber diretamente arquivos JPEG ou WebP. O endpoint atual ainda pode retornar conteúdo de imagem PNG. Se seu produto precisar de JPEG ou WebP, receba PNG primeiro e converta-o no seu código.

Fluxo de resposta

Este endpoint é síncrono. Depois de enviar POST /images/generations, mantenha a solicitação HTTP atual aberta até o servidor responder. Quando a geração é bem-sucedida, o conteúdo da imagem é retornado em data[0].b64_json. O endpoint não retorna task_id, e não há endpoint separado para consulta de status ou download do resultado.

Timeouts e novas tentativas

  • Defina timeouts do cliente HTTP para vários minutos.
  • Tente novamente erros de transporte, 408, 409, 425, 429 e 5xx.
  • Não tente novamente automaticamente 400, 401, parâmetros ausentes ou solicitações malformadas.
  • Use backoff exponencial, como 3s, 8s e 15s.
  • Se imagens duplicadas forem inaceitáveis, registre seu próprio ID de solicitação antes de tentar novamente.

Tratamento de erros

Os erros geralmente retornam JSON. Ao mostrar um erro, leia primeiro error.message, depois message e, por fim, o texto de status HTTP.

Checklist de integração

  • A Base URL é https://bettertoken.ai/v1.
  • O cabeçalho contém Authorization: Bearer YOUR_API_KEY.
  • A solicitação usa application/json e POST /images/generations.
  • model é gpt-image-2, response_format é b64_json, output_format é png e n é 1.
  • size é um dos valores recomendados, como 1024x1024.
  • Seu cliente HTTP permite vários minutos para a geração.

Documentação relacionada

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Corpo

application/json
model
enum<string>
padrão:gpt-image-2
obrigatório

Use the GPT Image 2 model ID.

Opções disponíveis:
gpt-image-2
Exemplo:

"gpt-image-2"

prompt
string
obrigatório

A detailed description of the image to generate.

Exemplo:

"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic."

n
padrão:1

Use 1. Send separate requests when you need multiple output images.

Exemplo:

1

size
enum<string>
padrão:1024x1024

The requested image size or aspect-ratio tier. The server may map or adjust the final pixel dimensions, so inspect the decoded image for its actual size.

Opções disponíveis:
auto,
1024x1024,
1536x1024,
1024x1536,
1536x1152,
1152x1536,
2048x2048,
2048x1152,
3840x2160,
2160x3840
Exemplo:

"1024x1024"

response_format
enum<string>
padrão:b64_json

Use b64_json.

Opções disponíveis:
b64_json
Exemplo:

"b64_json"

output_format
enum<string>
padrão:png

Use png. Do not rely on jpeg or webp being returned directly in the selected format.

Opções disponíveis:
png
Exemplo:

"png"

Resposta

Image generation result.