Operación
Lista de producción
Preparar una integración de generación fiable: costes, tareas, webhooks y recuperación ante errores.
La producción empieza antes de la llamada API: valide la entrada, calcule el precio, guarde el taskId y procese el resultado de forma asíncrona.
Principios prácticos
Elija el modelo según la prioridad — rapidez, fidelidad, resolución o control — y guarde parámetros y versión de cada resultado. the model selected for the task — Production checklist.
Cambie una sola cosa por intento. Las salidas buenas se convierten en referencias y en el punto de partida más fiable para la siguiente iteración.
Trate finished y failed como estados finales. Use polling o webhooks, conserve errores sin procesar en el servidor y muestre mensajes seguros al usuario.
Prompts y ejemplos de API
{"model": "veo3.1-fast","input": { "prompt": "…", "aspectRatio": "16:9" },"webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"}
{"code": 402,"error": {"message": "Insufficient balance. Please top up your account","type": "PaymentRequired","code": "insufficient_balance"}}
curl https://api.api-stock.com/api/v1/user/me \-H "Authorization: Bearer sk-your-key"
{"code": 200,"data": {"id": "019c1f70-2b44-70d3-9c22-6b7ad0f41e18","balance": 48250,"createdAt": "2026-01-14T09:03:11.000Z"}}
curl https://api.api-stock.com/api/v1/catalog
curl https://api.api-stock.com/api/v1/catalog/veo3.1-fast
Ejecútalo con tu propia clave
Todos los modelos de esta guía están disponibles en el catálogo de API Stock: una clave de API, un saldo prepago y ningún registro aparte por proveedor.