Краткий вывод
- Official capabilities include a 1M context window, up to 64K output, plus function calling, structured output, search tools, and code execution.
- Compared with classic lightweight Flash tiers, it is better suited to complex Q&A, coding, long-document handling, and agent workflows.
- The recommended integration path remains OpenAI-compatible chat so existing SDKs, SSE streaming, and retry middleware can be reused.
Частые ошибки
- 400 invalid_request_error: триггер=Missing required fields, malformed messages, or invalid parameter types in the payload.; исправление=Validate model, messages, max_tokens, and any tools/schema JSON before retrying.; повтор=Retry only after fixing the payload; avoid blind retries.
- 401 authentication_error: триггер=Missing Authorization header, malformed bearer token, or invalid API key.; исправление=Verify Authorization: Bearer <YOUR_API_KEY> format and key validity.; повтор=Retry after authentication is fixed.
- 429 rate_limit_error: триггер=Request rate, concurrency, or quota usage has hit upstream rate limiting.; исправление=Apply exponential backoff and inspect concurrency, context size, and current quota consumption.; повтор=Use 1s/2s/4s backoff with jitter; reduce concurrency or downgrade workload shape if it persists.
- 500 internal_error: триггер=Transient upstream instability, tool execution failure, or internal processing issues.; исправление=Capture request id and a compact context summary, then retry; escalate if failures persist.; повтор=Retry 2-3 times with short delays.