GPT Image 2: tu primera solicitud a la Image API

Qué necesitas

• curl para enviar la solicitud;
• tu propia API Key de BetterToken;
• la Base URL exacta https://www.bettertoken.ai/v1;
• el modelo gpt-image-2 para esta Image API;
• un decodificador Base64 o un script corto de Python.

No pongas una clave real en código fuente, capturas de pantalla ni en un comando que quede en el historial de tu shell. Guárdala en una variable de entorno:

export BETTERTOKEN_API_KEY="your_api_key_here"

El valor anterior es solo un marcador de posición. Usa tu propia clave y nunca la publiques.

Tu primera solicitud de GPT Image 2

Envía una solicitud al endpoint de generación de imágenes:

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

Si la solicitud funciona, image-response.json contiene un objeto data. La imagen está en data[0].b64_json. Este formato de respuesta funciona bien en flujos del lado del servidor: puedes guardar el payload en almacenamiento de objetos, pasarlo al siguiente paso de procesamiento o decodificarlo directamente en un archivo local.

Guardar la imagen

El siguiente ejemplo lee el JSON, decodifica el valor Base64 y crea bettertoken-image.png. Solo usa la biblioteca estándar de 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")

Abre el archivo y comprueba que corresponde al prompt. Un HTTP 200 confirma que la solicitud se realizó, pero no sustituye una revisión visual del resultado.

Mejorar la segunda solicitud

Para la primera prueba, utiliza un prompt corto con cuatro partes claras:

1. sujeto o escena;
2. estilo visual;
3. composición;
4. paleta o iluminación.

Por ejemplo:

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

No empieces con una lista larga de requisitos contradictorios. Comprueba primero la composición básica y modifica un parámetro cada vez. Así será más fácil saber qué redacción afectó al resultado.

Errores habituales

401: clave rechazada

Comprueba que BETTERTOKEN_API_KEY esté definida en la terminal actual y que la cabecera de autorización incluya el prefijo Bearer. No muestres la clave con echo ni envíes su valor completo al soporte.

402 o saldo insuficiente

Abre el Dashboard de BetterToken y comprueba el saldo disponible. El saldo pagado de BetterToken no se restablece automáticamente al final del mes, pero cada solicitud requiere saldo restante suficiente.

404: ruta incorrecta

La generación de imágenes utiliza esta ruta completa:

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

No la sustituyas por el endpoint Chat Completions ni uses api.openai.com: una clave de BetterToken funciona con el endpoint de BetterToken.

400: modelo o parámetros incorrectos

Empieza únicamente con los campos obligatorios model y prompt. Esta guía usa gpt-image-2. Si la API indica que el modelo no está disponible, compara el Model ID y los parámetros actuales con la documentación de la Image API.

429 o 5xx

No inicies un bucle infinito de reintentos. Registra el estado HTTP, la hora de la solicitud y una parte segura de la respuesta; después vuelve a intentarlo tras una espera. En el Dashboard de BetterToken puedes localizar la solicitud por hora e inspeccionar el modelo, estado, uso de tokens de entrada/salida/cache y el cargo sin ver el prompt completo.

Comprobaciones antes de integrarla en una aplicación

Antes de llevar la solicitud a un backend o flujo de automatización, confirma que:

• la clave se guarda en una variable de entorno o gestor de secretos;
• la solicitud se dirige a BetterToken y no al endpoint de otro proveedor;
• el modelo y los parámetros proceden de la documentación actual;
• el payload Base64 se decodifica sin errores;
• la aplicación limita los reintentos y maneja respuestas que no sean 2xx;
• el coste se comprueba con la página de precios actual, no con una reseña antigua.

Después puedes trasladar el mismo contrato al SDK o cliente HTTP de tu aplicación. Empieza con la solicitud mínima, guarda un resultado y solo entonces añade dimensiones, ajustes de calidad, procesamiento por lotes y tu propia capa de almacenamiento.

Versión breve

El primer flujo funcional tiene tres pasos: envía una solicitud POST a la BetterToken Image API, lee data[0].b64_json y decodifícala en un archivo. Si necesitas tu propia clave y facturación por uso, crea una cuenta BetterToken y comprueba los parámetros y precios actuales antes de ejecutar la solicitud.