Referenciav1.0.0 Estable

AI Image 2 API

Integra la generación de imágenes y la edición por referencia de GPT Image 2.0. Esta documentación cubre autenticación, los endpoints de generación y estado, límites y facturación.

https://gptimage2-ai.com

Inicio rápido

Completa tu primera llamada a la API en solo dos pasos: envía una tarea de generación y luego consulta su estado.

Enviar tarea

Envía una solicitud POST al endpoint de generación para obtener un ID de tarea.

Consultar estado

Usa el ID de tarea para comprobar el progreso hasta obtener la URL de la imagen.

Autenticación

Nota: mantén tu clave de API segura y no la expongas en código del lado del cliente.

Encabezado HTTP

Authorization: Bearer {YOUR_API_KEY}

POST

https://gptimage2-ai.com/api/generate

Crea una nueva tarea de generación o edición de imagen por referencia. Este endpoint es asíncrono y devuelve un task_id con el estado inicial; llama a /api/status para obtener las imágenes finales.

This endpoint responds immediately with task_id. Poll /api/status until the status becomes SUCCESS to obtain image URLs.

Parámetros del cuerpo

Nombre del parámetro	Tipo	Obligatorio	Descripción
`prompt`	string	Condicional	Prompt de texto que describe la imagen a crear (máx. 20000 caracteres). Obligatorio cuando images está vacío.
`images`	string[]	No	Array opcional de URLs de imágenes de referencia para editar o recombinar en lugar de generación pura por texto.
`aspect_ratio`	string	No	Proporción de salida. Valores permitidos: auto, 1:1, 5:4, 9:16, 21:9, 16:9, 4:3, 3:2, 4:5, 3:4, 2:3.
`resolution`	string	No	Resolución de salida: 1K (por defecto), 2K o 4K. 5:4 y 4:5 solo admiten 1K; 1:1 no admite 4K.

Respuesta (JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://gptimage2-ai.com/api/status

Consulta el estado de ejecución y los resultados de una tarea.

Parámetros de consulta

Nombre del parámetro	Obligatorio	Descripción
`task_id`	Sí	El ID devuelto al enviar la tarea.

Ejemplo de respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0"
    ],
    "consumed_credits": 10,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

Facturación

Coste por imagen

10 créditos / imagen

Las tareas fallidas no se cobran. Otros modelos del sitio usan sus propias tarifas.

Manejo de errores

401 UnauthorizedClave de API no válida
402 Payment RequiredSaldo insuficiente
429 Too Many RequestsDemasiadas solicitudes

Acerca de GPT Image 2.0

GPT Image 2.0 es el modelo de imagen detrás de AI Image 2. AI Image 2 es un servicio independiente, no afiliado, respaldado ni patrocinado por OpenAI.

GPT Image 2.0 — generación fiel al prompt con texto legible en la imagen

GPT Image 2.0 sigue instrucciones detalladas con precisión, renderiza texto legible dentro de las imágenes y acepta fotos de referencia para editar una imagen existente.

Hecho para tipografía, maquetas y edición por referencia

El modelo rinde bien en pósters, infografías y mockups de UI donde el texto debe seguir siendo legible, y conserva el sujeto al cambiar estilo o fondo cuando se aportan imágenes de referencia.

Puntos fuertes

Texto legible en la imagen — titulares, etiquetas y eslóganes cortos dentro de pósters e infografías.
Edición por referencia — pasa URLs de imágenes para reestilizar o recomponer una foto conservando el sujeto.
Maquetas estructuradas — composiciones multielemento como menús, flyers y storyboards con paneles ordenados.
Salida de 1K a 4K — elige 1K, 2K o 4K; 4K no disponible en 1:1, y 5:4 / 4:5 solo en 1K.
Once proporciones — auto, 1:1, 5:4, 9:16, 21:9, 16:9, 4:3, 3:2, 4:5, 3:4 y 2:3.
Precio fijo — cada imagen cuesta 10 créditos, cobrados solo si la tarea tiene éxito.

Cómo usar

promptprompt — descripción en lenguaje natural; incluye el texto exacto a renderizar (máx. 20000 caracteres).
imagesimages — array opcional de URLs de referencia; el modelo las edita o recombina.
resolutionresolution — 1K (por defecto), 2K o 4K; todos los tamaños cuestan los mismos 10 créditos.

GPT Image 2 prompts Examples