Operación

Lista de producción

Preparar una integración de generación fiable: costes, tareas, webhooks y recuperación ante errores.

1 min de lectura2 secciones

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

json

{
  "model": "veo3.1-fast",
  "input": { "prompt": "…", "aspectRatio": "16:9" },
  "webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"
}

json

{
  "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"

json

  {
    "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

Elija un modelo en el catálogo de API Stock, consulte su precio y pruébelo en el navegador o por API.

Ver el catálogo Referencia de la API

Lista de producción

Principios prácticos

Prompts y ejemplos de API

Ejecútalo con tu propia clave

Seguir leyendo