Skip to main content
POST
cURL
POST /v1/images/generations El endpoint de texto a imagen usa un cuerpo de solicitud application/json. Envía un prompt, mantén abierta la solicitud HTTP y lee la imagen generada desde data[0].b64_json en la misma respuesta.
Usa https://www.bettertoken.ai/v1 como Base URL. Envía tu BetterToken API Key mediante Authorization: Bearer YOUR_API_KEY.
Puedes introducir Authorization y el cuerpo de la solicitud en el Playground de la derecha. Después, envía la solicitud directamente a https://www.bettertoken.ai/v1/images/generations.
No incluyas API Keys en código frontend del navegador, repositorios Git, tickets, capturas de pantalla ni registros. En llamadas mediante un proxy del servidor, guarda las API Keys únicamente en variables de entorno del servidor o en un gestor de secretos.

Inicio rápido con curl

Usa https://www.bettertoken.ai/v1 como Base URL y envía una solicitud a https://www.bettertoken.ai/v1/images/generations:

Valores recomendados

Envía estos campos de forma explícita en cada solicitud:
Para generar varias imágenes, envía varias solicitudes independientes. No dependas de una sola solicitud con n > 1.

Tamaños recomendados

size representa la proporción y el nivel de tamaño esperados. El servidor puede asignar o ajustar los píxeles devueltos. Usa las dimensiones de la imagen decodificada en lugar de recortar la salida por la fuerza al valor solicitado.

Guarda la imagen

Una respuesta correcta sigue la estructura de imagen compatible con OpenAI:
Lee data[0].b64_json y guárdalo como contenido de imagen en base64. La respuesta puede incluir campos adicionales como revised_prompt; permite esos campos en tu cliente. Define siempre output_format: "png". Después, guarda la imagen decodificada como .png sin inspeccionar las cabeceras del archivo.

Ejemplo con JavaScript (Node.js)

No confíes en output_format: "jpeg" ni en output_format: "webp" para recibir directamente archivos JPEG o WebP. El endpoint actual puede seguir devolviendo contenido de imagen PNG. Si tu producto necesita JPEG o WebP, recibe primero el PNG y conviértelo en tu propio código.

Flujo de respuesta

Este endpoint es síncrono. Después de enviar POST /images/generations, mantén abierta la solicitud HTTP hasta que responda el servidor. Cuando la generación se completa, el contenido de la imagen se devuelve en data[0].b64_json. El endpoint no devuelve un task_id, y no existe un endpoint separado para consultar el estado o descargar el resultado.

Tiempos de espera y reintentos

  • Configura tiempos de espera de varios minutos en el cliente HTTP.
  • Reintenta los errores de transporte, 408, 409, 425, 429 y 5xx.
  • No reintentes automáticamente 400, 401, parámetros ausentes ni solicitudes mal formadas.
  • Usa espera exponencial, por ejemplo, 3s, 8s y 15s.
  • Si no puedes aceptar imágenes duplicadas, registra tu propio ID de solicitud antes de reintentar.

Gestión de errores

Los errores suelen devolver JSON. Al mostrar un error, lee primero error.message, después message y, por último, el texto del estado HTTP.

Lista de integración

  • La Base URL es https://www.bettertoken.ai/v1.
  • La cabecera contiene Authorization: Bearer YOUR_API_KEY.
  • La solicitud usa application/json y POST /images/generations.
  • model es gpt-image-2, response_format es b64_json, output_format es png y n es 1.
  • size es uno de los valores recomendados, como 1024x1024.
  • Tu cliente HTTP permite varios minutos para la generación.

Documentación relacionada

Autorizaciones

Authorization
string
header
requerido

Use your BetterToken API Key as a bearer token. Do not expose API keys in frontend browser code, screenshots, logs, tickets, or Git repositories.

Cuerpo

application/json
model
enum<string>
predeterminado:YOUR_MODEL_ID
requerido

固定使用 YOUR_MODEL_ID。

Opciones disponibles:
YOUR_MODEL_ID
Ejemplo:

"YOUR_MODEL_ID"

prompt
string
requerido

图片生成提示词。

Ejemplo:

"一张未来感 AI 产品海报,浅色背景,玻璃质感,干净构图,高级科技感"

n
integer
predeterminado:1

推荐固定为 1。多张图片建议发起多次独立请求。

Rango requerido: 1 <= x <= 1
Ejemplo:

1

size
enum<string>
predeterminado:1024x1024

图片尺寸和比例档位。auto 为自动;1024x1024 和 2048x2048 为 1:1;1536x1024 为 3:2;1024x1536 为 2:3;1536x1152 为 4:3;1152x1536 为 3:4;2048x1152 和 3840x2160 为 16:9;2160x3840 为 9:16。实际返回像素可能由服务端映射或调整,客户端应以解码后的真实图片尺寸为准。

Opciones disponibles:
auto,
1024x1024,
1536x1024,
1024x1536,
1536x1152,
1152x1536,
2048x2048,
2048x1152,
3840x2160,
2160x3840
Ejemplo:

"1024x1024"

response_format
enum<string>
predeterminado:b64_json

推荐固定为 b64_json,便于稳定保存图片。

Opciones disponibles:
b64_json
Ejemplo:

"b64_json"

output_format
enum<string>
predeterminado:png

推荐固定为 png。不要依赖 jpeg 或 webp 直接返回对应格式。

Opciones disponibles:
png
Ejemplo:

"png"

Respuesta

Image generation result.

OpenAI-compatible image response. Clients should read data[0].b64_json and allow additional fields such as revised_prompt.

created
integer
Ejemplo:

1710000000

data
object[]