Integración en producción

Elegir modelo y protocolo

Lee inputSchema y los ejemplos del catálogo autenticado. enabled y available deben ser true. Una ficha pública no demuestra que tu cuenta pueda ejecutar el modelo. Las tareas nativas usan /api/v1 y los clientes compatibles /v1. Las cookies de Console no son credenciales de API.

Preparar la entrada en el servidor

Guarda la clave en el backend, fuera del navegador, las aplicaciones distribuidas y los repositorios públicos. Respeta tipos, valores y requisitos condicionales del esquema vigente. Para el flujo de carga administrada, solicita la autorización, haz PUT y commit, y usa la referencia devuelta. También puedes usar una URL pública o datos Base64 cuando el esquema del modelo y el campo admitan ese formato. Valida de nuevo al cambiar de modelo.

Confirmar el precio antes de enviar

Envía model, input y callBackUrl completos a jobs/quote. Muestra estimatedCost, maxCharge, currency y expiresAt. La cotización dura cinco minutos y no inmoviliza saldo. Tras la confirmación, añade quoteId y expectedCost a la misma solicitud. Si cambian las entradas o aparece 40901, solicita una nueva cotización; no aceptes aumentos automáticamente. Conserva los importes como decimales.

Guardar la operación de negocio

Antes del envío, guarda el ID de operación, una huella segura y el Idempotency-Key; después añade taskId y request_id. Reutiliza la clave durante 24 horas para la misma cuenta, clave API y operación. Un timeout no demuestra que la solicitud haya sido rechazada. Reintentar un fallo terminal crea una tarea nueva con las condiciones actuales.

Procesar callbacks y resultados

Verifica firma y fecha sobre los bytes originales; elimina duplicados y persiste antes de responder rápidamente. Delega el trabajo lento a tu cola. Trata avisos repetidos o tardíos según el estado. Usa recordInfo con intervalos de espera que aumentan de forma exponencial hasta un máximo como respaldo. 202 significa aceptado, succeeded confirma la generación y settled=true la liquidación.

Limitar concurrencia y retención

Limita las tareas simultáneas por cuenta y el tiempo de las solicitudes. En 429 respeta Retry-After; evita consultar todas las tareas cada segundo. El catálogo admite caché privada breve. Las URL firmadas duran 20 minutos; los resultados se conservan 14 días y los archivos subidos, un día. Las URL de resultado incluidas en las respuestas evitan una llamada adicional para obtener el archivo. Archiva lo que necesites conservar. Desconectarse no cancela una tarea aceptada.

Validar antes del lanzamiento

Comprueba catálogo, saldo y cotizaciones antes de una generación mínima con confirmación del costo. Prueba éxito, entradas inválidas, saldo insuficiente, recuperación con la misma clave, callbacks duplicados, enlaces caducados y límites de presupuesto. Registra request_id, taskId, hora, estado e importe, nunca claves ni prompts completos.

Flujos relacionados

Cotizaciones y compatibilidad · Modelos y endpoints · Carga y descarga de medios · Webhooks · Errores y reintentos · Diagnóstico y recuperación