Exploitation

Checklist de production

Préparer une intégration de génération fiable : coûts, tâches, webhooks et reprise après erreur.

1 min de lecture2 sections

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

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

Essayez avec votre propre clé

Tous les modèles de ce guide sont disponibles dans le catalogue API Stock — une clé d’API, un solde prépayé, aucune inscription séparée par fournisseur.

Parcourir le catalogue Référence de l’API

À lire ensuite

Principes pratiques

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.

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