# AIRUS в n8n

1. Credentials → OpenAI API: Base URL https://airus.world/v1, API Key из env AIRUS_API_KEY.
2. Узел OpenAI Chat Model → модель airus:auto (или из GET /v1/models).
3. Подпишись на webhook budget.* (кабинет → Webhooks) — предупреждение до стоп-крана.
4. Передавай metadata.feature/client_id для затрат по клиентам.

Правила:
- Никогда не хардкодь ключ — читай из env AIRUS_API_KEY.
- Для backend/n8n/CI используй service account ключи (keyType: service), а не личные.
- Логируй request_id из ответа (заголовок x-request-id) для трассировки и сверки списаний.
- Ставь timeout >= 60s на production-вызовы (генерация бывает долгой).
- Обрабатывай коды: 401, 402, 403, 429, 451, 500, 502, 503, 504 — см. GET /v1/airus/errors (Error Doctor).
- Передавай metadata (feature, client_id, environment) — это включает cost-атрибуцию и receipts.
- Не полагайся на плавающие алиасы (airus:auto*) в проде без явного запроса пользователя — фиксируй модель, если нужна воспроизводимость.
- Задай дневной бюджет в политике проекта и подпишись на webhook budget.threshold_reached.
- Стриминг: stream:true, читай SSE до data: [DONE]; usage приходит в финальном чанке.