aisplice

Referencia de la API

Imágenes: respuesta directa

Ningún modelo lo admite todavía

Ahora mismo ningún modelo del catálogo admite esta ruta. La página se mantiene como referencia.
POST/v1/images/generations

Generación de imágenes síncrona para los modelos que atienden esta ruta, en un único cuerpo con formato OpenAI. La respuesta incluye las URL finales de las imágenes.

#Parámetros de la solicitud

  • modelstringobligatorio

    Un modelo de imagen que atiende esta ruta síncrona. Los modelos solo de tareas la rechazan — usa /v1/images/tasks.

  • promptstringobligatorio

    Qué dibujar.

  • nintegeropcional

    Número de imágenes (la facturación se multiplica por imagen).

  • sizestringopcional

    Proporción predefinida como "16:9" — la que usan la mayoría de los modelos de imagen; los valores exactos están en la ficha del modelo. Algunos modelos más antiguos también aceptan WIDTHxHEIGHT.

  • resolutionstringopcional

    Nivel de resolución de salida como "1K", "2K" o "4K", cuando la ficha del modelo lo incluye — también una dimensión del nivel de precio.

  • qualitystringopcional

    Nivel de calidad del proveedor (p. ej. standard / hd) — también una dimensión del nivel de precio.

  • response_formatstringopcional

    "url" (predeterminado) o "b64_json" para bytes en línea.

Precios por niveles

size, quality y duration seleccionan el nivel facturado — la ficha del modelo indica el precio exacto por nivel, y las llamadas fallidas se reembolsan automáticamente.

#Errores relacionados

  • 422 unprocessable_entityEl proveedor rechazó valores de parámetros que el gateway reenvió (p. ej. tamaño o duración no admitidos).
  • 401Bearer token no válido o ausente. Esta ruta no tiene error.code — compara por el estado.
  • 402 insufficient_user_quotaEl saldo de la billetera no cubre la estimación reservada previamente.
  • 429Limitación por clave. Cuerpo vacío; espera el Retry-After. Un 429 que sí incluye insufficient_user_quota indica en cambio un límite de gasto diario.
  • 503 model_not_foundModelo desconocido, o ningún canal sano lo atiende ahora mismo.

Tabla completa de códigos de error →

#Ejemplo de solicitud

curl https://www.aisplice.store/v1/images/generations \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_SYNC_IMAGE_MODEL",
    "prompt": "A cyberpunk skyline at dusk, neon rain",
    "size": "1:1"
  }'

#Respuesta

response.json
{
  "created": 1720000000,
  "data": [{"url": "https://…"}]
}

¿Sigues con el problema?

Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.

AnteriorMessages (formato Anthropic)SiguienteImágenes: tareas asíncronas