Errori e limiti

Gli errori hanno sempre la forma:

{ "error": { "code": "insufficient_credits", "message": "…", "price_cents": 50, "balance_cents": 20 } }

HTTP	code	Significato
400	invalid_input, invalid_url, invalid_model, invalid_json	parametri non validi: il messaggio indica quale
401	unauthorized	chiave o token mancante, revocato o scaduto
402	insufficient_credits	credito insufficiente
403	tool_disabled	strumento temporaneamente disattivato
413	payload_too_large	corpo oltre 16 KB
429	rate_limited, too_many_concurrent	troppe chiamate: rallenta e riprova
502	audit_failed	il sito da analizzare non risponde (rimborsato)
503	capacity, no_models	capacità giornaliera raggiunta o nessun modello disponibile

Limiti predefiniti: 20 chiamate al minuto per chiave, 3 chiamate contemporanee per account, risposta entro 2 minuti. Nel server MCP gli errori degli strumenti arrivano come risultato con isError: true, così l'assistente può spiegarli all'utente.