Checklist de production

La production commence avant l’appel API : validez l’entrée, estimez le prix, enregistrez le taskId et traitez le résultat de façon asynchrone.

Principes pratiques

Choisissez le modèle selon la priorité — vitesse, fidélité, résolution ou contrôle — puis conservez les paramètres et la version utilisés pour chaque résultat. the model selected for the task — Production checklist.

Faites une modification par essai. Gardez les sorties satisfaisantes comme références : elles deviennent le point de départ le plus fiable pour l’itération suivante.

Traitez finished et failed comme des états finaux. Pour une intégration robuste, utilisez le polling ou un webhook, conservez les erreurs brutes côté serveur et montrez un message sûr à l’utilisateur.

Prompts et exemples d’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