GPT Image 2
OpenAI gpt-image-2 — high-fidelity image generation with strong prompt following and text rendering.
Precio
$0.0065/ llamada
Endpoint
/images/tasks
Modo de entrega
Ciclo de vida de las tareas asíncronas
Disponibilidad
Disponible ahora
Documentación de la API
Configura y copia la solicitud
Elige las opciones que acepta este modelo. El código de abajo se actualiza según lo que elijas.
https://www.aisplice.store/v1/images/tasksBearer API keyTarea asíncronaOpcionesSolo se muestran las opciones publicadas para este modelo.
# Requires curl and jq
API_KEY="${API_KEY:-YOUR_API_KEY}"
# 1. Submit once
SUBMITTED=$(curl --fail-with-body -sS https://www.aisplice.store/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: model-docs-$(date +%s)-$$" \\
-d '{
"model": "GPT Image 2",
"prompt": "A cinematic scene with careful composition",
"size": "1:1",
"resolution": "1K",
"quality": "auto",
"n": 1
}')
TASK_ID=$(printf '%s' "$SUBMITTED" | jq -r '.task_id // .id // empty')
if [ -z "$TASK_ID" ]; then
printf '%s\n' "$SUBMITTED" >&2
exit 1
fi
echo "task_id=$TASK_ID"
# 2. Poll until terminal
while true; do
STATUS_JSON=$(curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY")
STATUS=$(printf '%s' "$STATUS_JSON" | jq -r '.status // empty' | tr '[:upper:]' '[:lower:]')
echo "status=$STATUS"
case "$STATUS" in
completed|succeeded|success) break ;;
failed|failure|cancelled|canceled)
printf '%s\n' "$STATUS_JSON" | jq .
exit 1
;;
esac
sleep 3
done
# 3. Fetch the final result
curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID/content" \
-H "Authorization: Bearer $API_KEY" | jq .- 1Envía la tarea
- 2Consulta el estado
- 3Obtén el contenido
Se recomiendan URL públicas de medios para producción. Sube primero un archivo local y luego pon public_url en la solicitud al modelo. Evita cuerpos Base64 grandes.
Leer la guía de subidaReferencia de parámetros
modelIdentificador exacto del modelo para esta solicitud.
gpt-image-2promptInstrucción que describe el resultado deseado.
sizeRelación de aspecto o dimensiones de salida.
auto1:13:22:34:33:45:44:516:99:162:11:23:11:321:99:21resolutionRequests the selected resolution natively, then applies professional upscaling only when returned pixels are below the fulfillment threshold.
1K2K4KqualityNivel de calidad de salida solicitado.
autolowmediumhighn1imagesOptional reference images for image editing, up to 16.
Ciclo de vida de la respuesta
Estado de la tarea, estados finales y ejemplos de respuesta del resultado.
Ciclo de vida de la respuesta
Estado de la tarea, estados finales y ejemplos de respuesta del resultado.
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "image.task",
"model": "GPT Image 2",
"status": "queued"
}{
"created": 1720000000,
"data": [
{
"url": "https://media.example/result.png"
}
]
}En espera
queued · submitted · in_progress · processing
Éxito
completed · succeeded · success
Fallo
failed · failure · cancelled · canceled
Errores y producción
Reglas de reintento, idempotencia y la lista mínima para producción.
Errores y producción
Reglas de reintento, idempotencia y la lista mínima para producción.
400 / 422Corrige los campos de la solicitud o la opción no admitida; no reintentes sin cambios.
401Comprueba que la clave de API esté presente, activa y se envíe como Bearer token.
402El saldo de la cuenta es insuficiente.
409La Idempotency-Key se está procesando o se reutilizó con otro cuerpo.
429Aplica backoff según Retry-After antes de reintentar.
5xxReintenta con backoff exponencial y conserva la Idempotency-Key original.
- En apps públicas móviles y de navegador, mantén las claves de API en tu servidor.
- Define una Idempotency-Key única para cada operación asíncrona facturable.
- Guarda task_id para que la consulta pueda reanudarse tras un reinicio.
- Usa un timeout en cada solicitud HTTP e incluye el ID de solicitud en los reportes a soporte.
- Lee los metadatos de los modelos en vivo en lugar de fijar en el código los precios y las opciones admitidas.
Precio y niveles
Precio por solicitud
$0.0065/ llamada
Precios por niveles
Precio base $0.0065
Precios por niveles — el precio final depende de las opciones que solicites. Los niveles no listados se facturan al precio base.
- 16:9×1$0.0065
- 1:1×1$0.0065
- 1:2×1$0.0065
- 1:3×1$0.0065
- 21:9×1$0.0065
- 2:1×1$0.0065
- 2:3×1$0.0065
- 3:1×1$0.0065
- 3:2×1$0.0065
- 3:4×1$0.0065
- 4:3×1$0.0065
- 4:5×1$0.0065
- 5:4×1$0.0065
- 9:16×1$0.0065
- 9:21×1$0.0065
- auto×1$0.0065
- 1k×1$0.0065
- 2k×2.138040769231$0.013897
- 4k×2.138040769231$0.013897
- low:2k×1.189673461538$0.007733
- low:4k×1.189673461538$0.007733
- auto:2k×2.138040769231$0.013897
- auto:4k×2.138040769231$0.013897
- medium:2k×2.138040769231$0.013897
- medium:4k×2.138040769231$0.013897
- high:2k×8.586938461538$0.055815
- high:4k×8.586938461538$0.055815
- 1k×1$0.0065
- 2k×2.138040769231$0.013897
- 4k×2.138040769231$0.013897
El precio que ves aquí es exactamente lo que se te factura — las llamadas fallidas se reembolsan automáticamente.
Modelos relacionados