OpenAI · API de medios

GPT-Image 2.5 API

GPT-Image 2.5 es el modelo de imagen más reciente de OpenAI en OmniaKey: cubre generación desde texto y edición con Base64 en línea, devolviendo exactamente el tamaño que pides.

Obtén tu clave API Leer la documentación

ID del modelo: gpt-image-2.5
Proveedor: OpenAI
Modalidad: AI Imagen
Por llamada correcta: $0,10
Última verificación: 2026-09-11

Para qué sirve

Usa GPT-Image 2.5 para generaciones de mayor fidelidad y ediciones con referencia donde importe respetar el tamaño de salida; elige GPT-Image 2 cuando la prioridad sea el precio por llamada más bajo.

Qué hace

Texto a imagen

Convierte un texto en una imagen nueva.

Edición de imagen

Modifica una imagen existente a partir de un texto y una referencia.

Cómo llamarlo

Los modelos de medios funcionan de forma asíncrona: crea una tarea, consúltala hasta que termine y descarga la URL firmada del recurso.

Crear, consultar, descargar

# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: gpt-image-2.5-001" \
  -d '{
    "model": "gpt-image-2.5",
    "type": "image",
    "operation": "generate",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"size": "1024x1024", "quality": "medium"}
  }'

# 2. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 3. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"

Precio

Los trabajos de imagen se cobran por llamada correcta, no por token. Los trabajos fallidos o cancelados se reembolsan automáticamente.

Por llamada correcta

$0,10por llamada

Más modelos de imagen de OpenAI

GPT-Image 2

gpt-image-2

Preguntas frecuentes

¿Cómo llamo a GPT-Image 2.5 en OmniaKey?

Envía un POST a /v1/media/tasks con el id del modelo, type "image" y operation "generate" o "edit". Reutiliza la misma Idempotency-Key en los reintentos para que un timeout nunca inicie un segundo trabajo de pago.

¿Cuánto cuesta GPT-Image 2.5?

GPT-Image 2.5 se cobra a $0,10 por llamada. La creación pre-cobra ese importe de tu saldo prepago y los trabajos fallidos o cancelados se reembolsan automáticamente.

¿Por qué la API devuelve un id de tarea en lugar de la imagen?

La latencia del proveedor va de segundos a cerca de un minuto, así que OmniaKey normaliza todas las rutas de imagen en un mismo ciclo asíncrono. Consulta GET /v1/media/tasks/{id} hasta que el estado sea succeeded y luego lee la URL firmada del recurso.