ReferenciaGPT Image 2.5 Estable

Guía de API del Studio de TopviewAI Pro

Gestiona claves API y conoce las solicitudes del Studio con sesión iniciada. El ejemplo usa GPT Image 2.5; los demás modelos tienen sus propios formatos de solicitud.

https://topviewai.pro

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

Estos endpoints del Studio requieren una sesión iniciada y una clave API. Una clave Bearer por sí sola no basta. Mantén la clave privada.

Cabecera HTTP

Authorization: Bearer {YOUR_API_KEY}

POST

https://topviewai.pro/api/image/gpt-image-2-5/generate

Envía una solicitud de imagen a GPT Image 2.5. La respuesta devuelve un task_id; consulta el resultado en el endpoint de estado correspondiente.

La solicitud es asíncrona: guarda task_id y consulta el estado hasta SUCCESS o un error definitivo.

Parámetros del cuerpo

Nombre del parámetro	Tipo	Obligatorio	Descripción
`prompt`	string	Sí	Describe la imagen con entre 1 y 20 000 caracteres.
`aspect_ratio`	string	No	Relación de aspecto opcional; el valor predeterminado es auto. Ejemplos: 1:1, 4:3, 3:4, 16:9, 9:16.

Respuesta (JSON)

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

GET

https://topviewai.pro/api/image/gpt-image-2-5/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": "Una puesta de sol sobre las montañas",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 4,
    "created_at": "2026-11-05 13:05:09",
    "error_message": null
  }
}

Facturación

Ejemplo de coste de GPT Image 2.5

4 créditos / imagen 1K

El coste varía según el modelo, la resolución y los ajustes. Revisa la estimación del Studio y el consumo indicado por la tarea.

Manejo de errores

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

Acerca de TopviewAI Pro

Un Studio para vídeo, imágenes, edición, voz y audio.

Elige el modelo para cada tarea

Usa Seedance 2.5 para vídeo, GPT Image 2.5 para imágenes y los demás modelos del Studio. Cada modelo conserva su nombre real.

Un saldo, costes por modelo

Elige una suscripción o una recarga puntual por uso. Los créditos pagan los modelos y herramientas que utilices.

Herramientas de imagen Herramientas de vídeo