Identifiants Publics À Capturer
| Identifiant | Où il apparaît | Utilisez-le pour |
|---|---|---|
request_id | Corps d’erreur, journaux de tableau de bord, enregistrements d’utilisation | Support et réconciliation au niveau de la demande |
id / task_id | Réponses de création asynchrone et de statut | Polling d’images, vidéos, musique et travaux 3D |
poll_url | Réponses de création asynchrone | URL de statut préférée |
billing_transaction_id | Réponses non-streaming lorsqu’elles sont réglées, réponses de statut de tâche asynchrone, enregistrements d’utilisation, X-Billing-Transaction-ID | Réconciliation des coûts |
X-Task-ID | En-têtes de réponse de tâche asynchrone | Corrélation de tâche au niveau de l’en-tête |
| Votre propre ID de travail/utilisateur | Votre application | Lier l’activité de TokenLab au flux de travail de l’utilisateur |
Ce Qu’il Faut Enregistrer
Enregistrez suffisamment d’informations pour diagnostiquer la demande sans divulguer de secrets :- Point de terminaison, méthode HTTP, modèle, code d’état, horodatage et latence.
- Identifiants publics :
request_id,task_id,poll_url, etbilling_transaction_idlorsqu’ils sont présents. - Forme de demande assainie : quels champs étaient présents, pas l’intégralité de l’invite ou du contenu média privé.
- Réponses de statut asynchrone terminales, y compris les champs d’erreur publics.
- Compte de tentatives du client et si la tentative a créé une nouvelle tâche ou a repris une tâche existante.
Authorization, clés API, jetons de gestion, URLs signées, URLs de médias privés, invites complètes et données personnelles de l’utilisateur à moins que vous n’ayez une autorisation explicite de les conserver.
Matrice de Dépannage
| Symptôme | Première vérification | Page utile |
|---|---|---|
401 ou 403 | Clé API, jeton de gestion, accès à l’organisation, portée de la clé | Authentification |
402 | Solde, limite de dépenses de la clé API, disponibilité des prix des modèles | Facturation & Tarification |
429 | Niveau de compte, limite de taux de point de terminaison, comportement de réessai | Limites de Taux |
400 invalid_request_error | Champ non pris en charge, mauvais point de terminaison, champ requis manquant, ou incompatibilité de contrat de modèle | Gestion des Erreurs |
| Tâche asynchrone introuvable | Mauvaise clé API, ID de tâche périmé, tâche expirée, ou ID de tâche non publique | Travaux Asynchrones & Polling |
| Le coût ne correspond pas à l’UI | Timing de règlement ou comparaison du mauvais identifiant | Facturation & Tarification |
Réconciliation d’Utilisation
Utilisez l’API de Gestion pour la réconciliation côté serveur :GET /v1/management/api-keys/{keyId}/usage peut filtrer par scene, accessChannel, logicalModel, modelVendor, startDate, et endDate. Utilisez ces enregistrements au lieu de scraper les pages de tableau de bord ou de vous fier aux ID de tâches du fournisseur en amont.
Les réponses de streaming peuvent se régler après l’envoi du flux, donc un en-tête de facturation peut être absent même lorsque l’utilisation est enregistrée ultérieurement. Les tâches de médias asynchrones peuvent se régler après un polling terminal.
Modèle de Packet de Support
Lors de la prise de contact avec le support, incluez :request_id.task_idetpoll_urlpour le travail asynchrone.billing_transaction_idlorsqu’il est présent.- Point de terminaison, méthode, modèle, horodatage et code d’état.
- Forme de demande assainie et corps d’erreur public.
- Votre résultat attendu et ce que l’utilisateur a réellement vu.
Vérifications Opérationnelles
- Alertez sur les réponses répétées
401,402,429, et5xxséparément ; elles ont généralement des propriétaires différents. - Suivez les travaux asynchrones qui restent non terminaux plus longtemps que votre SLA produit.
- Suivez les tentatives de création en double pour le même ID de travail utilisateur.
- Échantillonnez les travaux complétés et vérifiez que l’actif visible par l’utilisateur, l’enregistrement d’utilisation, et l’enregistrement de tâche stocké sont d’accord.
Référence API
| Sujet | Référence |
|---|---|
| Gestion des Erreurs | Gestion des Erreurs |
| Limites de Taux | Limites de Taux |
| Facturation & Tarification | Facturation & Tarification |
| Obtenir l’Utilisation de la Clé API | Obtenir l’Utilisation de la Clé API |
| Obtenir le Statut de la Tâche | Obtenir le Statut de la Tâche |