API de geração de imagens
Gere imagens a partir de texto com GPT Image 2 e a API compatível com OpenAI da BetterToken: API Key, Base URL, parâmetros, Python, JavaScript e erros.
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.
https://bettertoken.ai/v1 como Base URL. Passe sua BetterToken API Key por Authorization: Bearer YOUR_API_KEY.Escolha o fluxo correto
- Gerar uma imagem a partir de texto e salvar o resultado: permaneça nesta página. Comece pelo exemplo de
curle depois use Salvar a imagem para decodificardata[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
Usehttps://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: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: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)
Fluxo de resposta
Este endpoint é síncrono. Depois de enviarPOST /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,429e5xx. - Não tente novamente automaticamente
400,401, parâmetros ausentes ou solicitações malformadas. - Use backoff exponencial, como
3s,8se15s. - 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 primeiroerror.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/jsonePOST /images/generations. modelégpt-image-2,response_formatéb64_json,output_formatépngené1.sizeé um dos valores recomendados, como1024x1024.- Seu cliente HTTP permite vários minutos para a geração.
Documentação relacionada
Autorizações
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Corpo
Use the GPT Image 2 model ID.
gpt-image-2 "gpt-image-2"
A detailed description of the image to generate.
"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic."
Use 1. Send separate requests when you need multiple output images.
1
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.
auto, 1024x1024, 1536x1024, 1024x1536, 1536x1152, 1152x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840 "1024x1024"
Use b64_json.
b64_json "b64_json"
Use png. Do not rely on jpeg or webp being returned directly in the selected format.
png "png"
Resposta
Image generation result.

