Skip to content

Tareas de imagen asíncronas

Estas rutas aceptan el mismo payload de imagen no streaming que el endpoint síncrono. Una entrega correcta devuelve 202 Accepted, poll_url y Retry-After; consulta esa URL con la misma Key hasta completed o failed. Si no hay almacenamiento de tareas de imagen en el servidor, la función devuelve 404 sin aceptar trabajo.

Configuración

bash
curl 'https://ai.tavonilo.com/v1/images/generations/async' \
  -H "Authorization: Bearer $AI_SHOP_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"<IMAGE_MODEL_ID>","prompt":"A minimal product illustration"}'

# The 202 response contains poll_url. Query that URL with the same key.

Estas rutas aceptan el mismo payload de imagen no streaming que el endpoint síncrono. Una entrega correcta devuelve 202 Accepted, poll_url y Retry-After; consulta esa URL con la misma Key hasta completed o failed. Si no hay almacenamiento de tareas de imagen en el servidor, la función devuelve 404 sin aceptar trabajo.

Verificación y recuperación

Comprueba la Key con /v1/models, realiza una solicitud pequeña sin datos sensibles y conserva sólo hora, ruta, modelo, estado HTTP e ID de solicitud para soporte. Un timeout no demuestra que una generación facturable no se procesó, por lo que no repitas ciegamente solicitudes largas o de imagen.

Límite de seguridad

Usa una Key por dispositivo o carga de trabajo. Nunca envíes a soporte una API Key, auth.json, prompt privado completo, contraseña, código de verificación o datos de pago; revoca y reemplaza una Key de inmediato si sospechas exposición.

Documentación relacionada

API access is subject to the AIShop service terms.