Erros e limites de requisições
Entenda os erros, tente novamente com segurança e recupere gerações com falha.
Resposta de erro#
Erros HTTP indicam uma solicitação rejeitada. Uma operação salva pode falhar depois e seu endpoint de status ainda retornar HTTP 200.
{ "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"}Recuperação#
| HTTP | Erro | Recuperação |
|---|---|---|
400 | Solicitação inválidaREQUEST_INVALID | Corrija os campos indicados pelo erro antes de tentar novamente. |
401 | Credencial inválidaCREDENTIAL_INVALID | Verifique a credencial, a validade e se foi revogada. |
402 | Créditos insuficientesINSUFFICIENT_CREDITS | Adicione créditos à conta da credencial e continue o trabalho salvo. |
403 | Permissão negadaSCOPE_REQUIRED | Use uma credencial com os escopos necessários e acesso ao recurso selecionado. |
404 | Recurso indisponívelRESOURCE_UNAVAILABLE | Verifique o ID do recurso e se pertence à conta autorizada. |
409 | Conflito de intençãoIDEMPOTENCY_CONFLICT | Reutilize uma intenção apenas com a solicitação original. Use um novo UUID para outra ação. |
429 | Limite de requisições atingidoRATE_LIMITED | Aguarde o prazo de Retry-After antes de repetir a mesma solicitação. |
503 | Temporariamente indisponívelDEPENDENCY_UNAVAILABLE | Aguarde Retry-After e repita com a mesma intenção. Verifique a operação salva após um tempo limite. |
Erro#
{ "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."}Tentativas e tempos limite#
Mantenha um UUID por ação e reutilize após timeout ou nova tentativa. Entradas diferentes com o mesmo UUID são rejeitadas.
curl 'https://platform.tongai.io/v1/operations/by-intent/45be69f1-c266-4a09-a82c-bf3c6303eb03' \ -H "Authorization: Bearer $TONG_API_KEY"Configuração
curl --versionLimites de requisições#
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: 12Respeite Retry-After. Após aguardar, repita uma falha temporária com a mesma intenção; não crie outra ação paga.