Intégration en production

Choisir le modèle et le protocole

Consultez le catalogue authentifié avec inputSchema et les exemples. enabled et available doivent être true. Une fiche publique ne prouve pas que votre compte peut appeler le modèle. Les tâches natives utilisent /api/v1, les clients compatibles /v1. Les cookies de la Console ne remplacent pas une clé API.

Préparer les entrées côté serveur

Gardez la clé API dans votre backend, hors des navigateurs, applications distribuées et dépôts publics. Respectez les types, valeurs et conditions du schéma actuel. Pour un fichier, demandez un ticket, effectuez le PUT puis commit, et transmettez son URI spicy:// dans le champ prévu. Revalidez après un changement de modèle.

Confirmer le prix avant envoi

Envoyez model, input et callBackUrl à jobs/quote. Présentez estimatedCost, maxCharge, currency et expiresAt. Le devis dure cinq minutes sans réserver de fonds. Après accord, ajoutez quoteId et expectedCost à la même requête. Une modification ou 40901 impose un nouveau devis, jamais une hausse acceptée silencieusement. Conservez les montants sous forme de chaînes décimales.

Conserver le lien avec votre opération

Avant envoi, enregistrez votre identifiant métier, une empreinte sûre et Idempotency-Key, puis taskId et request_id à réception. Pour le même compte, la même clé API et la même opération, réutilisez la clé pendant 24 heures. Un timeout ne prouve pas un refus. Relancer une tâche définitivement échouée crée une nouvelle tâche aux conditions actuelles.

Traiter les callbacks et les résultats

Vérifiez signature et horodatage sur les octets bruts, dédupliquez puis persistez. Répondez rapidement et placez les traitements longs dans votre file. Gérez les notifications retardées ou répétées selon l’état. Utilisez recordInfo avec un backoff exponentiel borné en secours. 202 signifie accepté, succeeded confirme la génération, settled=true la facturation finale.

Limiter la concurrence et archiver

Limitez les tâches en cours par compte et la durée des requêtes. Respectez Retry-After pour 429 et évitez les interrogations synchronisées chaque seconde. Le catalogue se met brièvement en cache privé. Les liens durent 20 minutes, les résultats 14 jours et les fichiers importés un jour. Archivez les résultats utiles. Une déconnexion n’annule pas une tâche acceptée.

Valider avant ouverture

Testez d’abord catalogue, solde et devis, puis une génération minimale après confirmation du coût. Vérifiez succès, paramètres invalides, solde insuffisant, reprise avec la même clé, callbacks répétés, liens expirés et budgets. Journalisez request_id, taskId, date, état et montant, sans clé ni prompt complet.

Parcours associés

Devis et compatibilité des protocoles · Modèles et points de terminaison · Téléversement et téléchargement des médias · Webhooks · Erreurs et nouvelles tentatives · Diagnostic et reprise des requêtes