Guía de la API de GPT-Image-2

GPT-Image-2 — API de generación de imágenes de OpenAI

Accede al último model de generación de imágenes de OpenAI a través de la API unificada de TokenHub. Totalmente OpenAI-compatible, con respuesta síncrona (sin necesidad de sondeo), varios tamaños de hasta 4K, niveles de calidad y formatos de salida PNG/JPEG/WebP. Admite tanto texto-a-imagen (t2i) como edición imagen-a-imagen (i2i, composición de varias imágenes e inpainting). Esta guía te lleva por toda la integración.

Text → ImageImage → Image (i2i)OpenAI-CompatibleSynchronousUp to 4KToken-based

1Obtén tu API Key

Visita tokenhub.store para crear una cuenta (se admite inicio de sesión con GitHub / Google)
Ve a Dashboard → API Keys y haz clic en "Create New Key"
Ve a Dashboard → Billing para añadir Credits (1 Credit = 1 USD)
Copia tu API Key (formato: th-xxxxxxxxxxxx...)

⚠️ La API Key solo se muestra una vez al crearla. Guárdala de forma segura. Si la pierdes, tendrás que crear una nueva.

2Resumen de la API

Base URL

https://tokenhub.store/api/v1

Autenticación

Todas las solicitudes requieren una API Key en el encabezado:

Header

Authorization: Bearer th-your-api-key

Endpoints (síncronos, OpenAI-compatible)

POST

/images/generations

Texto a imagen. Genera imágenes a partir de un prompt de texto.

POST

/images/edits

Edición de imagen a imagen. Admite ediciones de una sola imagen, composición de varias imágenes y inpainting opcional con una máscara.

3Precios

Nivel	Precio	Rango de resolución
1K	$0.125 / image	El lado más largo ≤ 1536 px (por ejemplo, 1024×1024, 1024×1536)
2K	$0.250 / image	El lado más largo ≤ 2048 px (por ejemplo, 2048×2048)
4K	$0.500 / image	Lado más largo > 2048 px (p. ej., 4096×4096)

Precio fijo por imagen según el nivel de resolución de salida (determinado por el lado más largo del tamaño). n imágenes = precio unitario × n. Las llamadas fallidas no se cobran.

Asignación por nivel según el lado más largo: ≤ 1536 px → 1K ($0.125), ≤ 2048 px → 2K ($0.250), > 2048 px → 4K ($0.500). Ejemplos: 1024×1024 y 1024×1536 son ambos 1K; 2048×2048 es 2K; 4096×4096 es 4K.

4Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
model	string	Obligatorio	—	ID del model. Usa "openai/gpt-image-2" (o la forma corta "gpt-image-2").
prompt	string	Obligatorio	—	Prompt de texto que describe la imagen a generar.
n	integer	Opcional	1	Número de imágenes a generar (1–10).
size	string	Opcional	1024x1024	Dimensiones de salida. Opciones: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840, auto.
quality	string	Opcional	auto	Calidad de generación. Opciones: auto, low, medium, high. Una mayor calidad consume más tokens.
format	string	Opcional	png	Formato de imagen de salida. Opciones: png, jpeg, webp.

Campos adicionales para /images/edits (i2i)

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
image	file / string \| array	Obligatorio	—	Imagen(es) de entrada para editar. Acepta archivos mediante multipart, o URL / URI de datos base64 en JSON. Proporciona varias para combinarlas en una sola salida.
mask	file / string	Opcional	—	Máscara de inpainting opcional. Las áreas transparentes se regenerarán; las áreas opacas se conservan.
input_fidelity	string	Opcional	low	Qué tanto preservar la entrada. Opciones: low, high. Usa high para mantener identidad/disposición; usa low para transformaciones más marcadas.
output_format	string	Opcional	png	Alias de 'format' para el endpoint de edición. Opciones: png, jpeg, webp.
output_compression	integer	Opcional	100	Nivel de compresión 0–100 (solo para jpeg / webp).

5Ejemplo completo con curl

bash

curl -X POST https://tokenhub.store/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "A serene Japanese garden at sunset, koi pond reflections, cherry blossoms, soft cinematic lighting, ultra-detailed"
  }'

Respuesta:

json

{
  "created": 1740000000,
  "data": [
    {
      "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

6Ejemplo completo en Python

python

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://tokenhub.store/api/v1",
)

result = client.images.generate(
    model="openai/gpt-image-2",
    prompt="A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
    n=1,
    size="1536x1024",
    quality="high",
)

image_url = result.data[0].url
print("Image URL:", image_url[:80], "...")

7Ejemplo completo en JavaScript / Node.js

javascript

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://tokenhub.store/api/v1",
});

const result = await client.images.generate({
  model: "openai/gpt-image-2",
  prompt: "A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
  n: 1,
  size: "1536x1024",
  quality: "high",
});

console.log("Image URL:", result.data[0].url.slice(0, 80), "...");

8Consejos de uso

Los prompts en inglés suelen dar los mejores resultados; también se admite chino.
Response data[].url puede ser una URL https simple o un data URI (base64). Maneja ambos casos al guardar en disco.
Para reducir el costo, usa calidad low/medium para borradores y solo usa high/tamaños 4K para la salida final.
El endpoint es síncrono — sin task id ni polling. Una solicitud suele tardar de 5 a 30 segundos según el tamaño y la calidad.
Configura el timeout HTTP a ≥ 120s en el cliente para evitar desconexiones prematuras con imágenes grandes.

9Preguntas frecuentes

¿Listo para empezar?

Regístrate en TokenHub y empieza a usar la API de GPT-Image-2 ahora

Obtener API Key Recargar Credits