Erreurs et limites de débit

Comprenez les erreurs, réessayez sans risque et reprenez les générations échouées.

Réponse d’erreur#

Les erreurs HTTP indiquent une requête rejetée. Une opération enregistrée peut échouer ensuite alors que son état répond toujours HTTP 200.

Réponse

JSON

{  "error": {    "code": "REQUEST_INVALID",    "message": "Check the request fields and try again.",    "request_id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",    "retryable": false  },  "request_id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8"}

Reprise#

HTTP	Erreur	Reprise
`400`	Requête invalide`REQUEST_INVALID`	Corrigez les champs indiqués par l’erreur avant de réessayer.
`401`	Identifiant invalide`CREDENTIAL_INVALID`	Vérifiez l’identifiant, son expiration et son éventuelle révocation.
`402`	Crédits insuffisants`INSUFFICIENT_CREDITS`	Ajoutez des crédits au compte de l’identifiant, puis poursuivez le travail enregistré.
`403`	Autorisation refusée`SCOPE_REQUIRED`	Utilisez un identifiant disposant des autorisations requises et de l’accès à la ressource choisie.
`404`	Ressource indisponible`RESOURCE_UNAVAILABLE`	Vérifiez l’ID de la ressource et son appartenance au compte autorisé.
`409`	Conflit d’intention`IDEMPOTENCY_CONFLICT`	Réutilisez une intention uniquement avec sa requête initiale. Utilisez un nouvel UUID pour une autre action.
`429`	Limite de débit atteinte`RATE_LIMITED`	Attendez le délai Retry-After avant de répéter la même requête.
`503`	Temporairement indisponible`DEPENDENCY_UNAVAILABLE`	Attendez Retry-After et réessayez avec la même intention. Vérifiez l’opération enregistrée après un délai dépassé.

Erreur#

JSON

{  "REQUEST_INVALID": "Check the request fields and try again.",  "TOOL_INPUT_INVALID": "The tool input does not match its public schema.",  "IDEMPOTENCY_KEY_REQUIRED": "Supply a UUID Idempotency-Key for this action.",  "IDEMPOTENCY_CONFLICT": "This intent was already used for different details.",  "CREDENTIAL_INVALID": "The credential is invalid, expired or revoked.",  "AUTHENTICATION_REQUIRED": "A valid credential is required.",  "SCOPE_REQUIRED": "The credential does not permit this action.",  "ACTION_FORBIDDEN": "This action is not permitted.",  "ORIGIN_DENIED": "This origin is not registered for the credential.",  "RESOURCE_UNAVAILABLE": "The requested resource is unavailable.",  "TOOL_UNAVAILABLE": "This tool is unavailable.",  "CURSOR_INVALID": "Refresh the list and try again.",  "ACTION_CHANGED": "The action or its target changed. Read its current state.",  "HUMAN_REVIEW_REQUIRED": "Review this action in the authenticated Tong dashboard.",  "REVIEW_EXPIRED": "This review expired. Read the current operation.",  "INSUFFICIENT_CREDITS": "Add credits to continue.",  "PAID_FEATURE_DEPOSIT_REQUIRED": "Complete the account deposit requirement to use this tool.",  "POLICIES_REQUIRED": "Accept the current account policies to continue.",  "ACCOUNT_UNAVAILABLE": "This account is unavailable.",  "RATE_LIMITED": "Too many requests. Retry after the indicated interval.",  "QUEUE_FULL": "The account work queue is full. Retry later.",  "WEBHOOK_LIMIT": "The account webhook limit has been reached.",  "WEBHOOK_DESTINATION_INVALID": "Use an allowed public HTTPS webhook destination.",  "QUOTE_INVALID": "The quote is invalid or does not match this request.",  "QUOTE_UNAVAILABLE": "The requested quote is unavailable.",  "EXPORT_NOT_READY": "The export is not ready for download.",  "EXPORT_TOO_LARGE": "Narrow the export interval or filters.",  "QUERY_TOO_LARGE": "Narrow the query interval or filters.",  "INTERVAL_INVALID": "Use a valid interval of at most 90 days.",  "UPLOAD_TOO_LARGE": "The upload exceeds the media purpose limit.",  "DEVELOPER_ACCESS_UNAVAILABLE": "Developer access is unavailable.",  "DEPENDENCY_UNAVAILABLE": "A required service is temporarily unavailable.",  "CATALOG_UNAVAILABLE": "The current model catalog is temporarily unavailable.",  "CONFIGURATION_INVALID": "Developer service configuration is unavailable."}

Nouvelles tentatives et délais#

Conservez un UUID par action et réutilisez-le après un délai ou une nouvelle tentative. Une entrée différente avec le même UUID est refusée.

curl 'https://platform.tongai.io/v1/operations/by-intent/45be69f1-c266-4a09-a82c-bf3c6303eb03' \  -H "Authorization: Bearer $TONG_API_KEY"

Configuration

curl --version

IdempotenceConservez un UUID par action et réutilisez-le après un délai ou une nouvelle tentative. Une entrée différente avec le même UUID est refusée.Requêtes et journauxUne requête acceptée n’est pas une génération terminée. Suivez le travail jusqu’à ce que le résultat soit prêt.

Limites de débit#

HTTP

Retry-After: {seconds}active_queue_per_account: 100admissions_per_minute: owner=500, credential=180, client=1000HTTP_per_minute: owner=5000, credential=2000, client=10000, IP=1000query_interval_max_days: 90export_max_rows: 100000export_max_bytes: 33554432webhooks_per_account: 10webhook_delivery_attempts: 12

Respectez Retry-After. Après attente, répétez un échec temporaire avec la même intention ; ne créez pas une seconde action payante.