Статьи NormaHub

Практика работы с AI API

Инструкции и разборы для тех, кто подключает AI-модели к приложениям, агентам и внутренним инструментам.

RSS-лента статей

Трек «Агенты»

От первого агента до продакшена: устройство, контекст, модели, деньги, наблюдаемость, долгая работа.

  1. 1. Что такое AI Agent
  2. 2. Context Engineering
  3. 3. Субагенты
  4. 4. Длинные агенты
  5. 5. Роутинг моделей
  6. 6. Наблюдаемость

Трек «Протоколы»

Как агент ходит к инструментам и к другим агентам: MCP, безопасность, совместимость, gateway.

  1. 1. MCP: доступ к инструментам
  2. 2. Безопасность MCP
  3. 3. MCP vs A2A
  4. 4. Матрица совместимости
  5. 5. Зачем AI Gateway
Безопасность3 минуты

Как безопасно хранить API-ключи для AI-сервисов

Практические правила хранения, передачи и ротации API-ключей нейросетей без утечек в браузер, репозиторий и логи.

Читать статью
Надёжность3 минуты

Ошибки AI API: что делать с 401, 402, 429 и 503

Практическая обработка ошибок AI API: авторизация, баланс, лимиты, временная недоступность, повторные запросы и request ID.

Читать статью
Разработка3 минуты

Streaming ответов AI через SSE: практическое руководство

Как устроена потоковая выдача AI через Server-Sent Events, как читать события, завершать поток и обрабатывать обрывы.

Читать статью
Инструменты3 минуты

Как подключить OpenCode к OpenAI-compatible API

Пошаговая схема подключения OpenCode к совместимому AI API через base URL, API-ключ и актуальный идентификатор модели.

Читать статью
Экономика3 минуты

Как рассчитать стоимость AI API по токенам

Разбираем входные и выходные токены, рост контекста, кеширование и формулу фактической стоимости запроса к нейросети.

Читать статью
Практика14 минут

AI API-провайдеры России: сравнение

Сравнение AI API-провайдеров России: наценки к прайсу, документы, модели, free-tier и аптайм. Методология, выводы «кому что», проверка 27.09.2026.

Читать статью
Практика10 минут

Как оплатить OpenAI API из России

Рабочие способы оплаты OpenAI API из России в 2026: агрегатор с рублями, виртуальные карты, зарубежные счета. Цены, риски, проверка 27.09.2026.

Читать статью
Практика2 минуты

Как подключить OpenAI-compatible API

Практическая инструкция по подключению OpenAI-compatible API: base URL, API key, выбор модели и первый запрос.

Читать статью
Практика2 минуты

Как выбрать AI API-провайдера для продукта

Критерии выбора AI API-провайдера: совместимость, модели, прозрачность стоимости, лимиты, стабильность и диагностика запросов.

Читать статью
Практика2 минуты

GPT и Claude в одном проекте

Как использовать GPT и Claude в одном продукте: выбор совместимого маршрута, разделение base URL и безопасная работа с API key.

Читать статью
Практика10 минут

Claude API в России без VPN

Claude API из России без VPN: почему прямой доступ закрыт, рабочие маршруты через агрегатор, выбор модели Opus, Sonnet или Haiku и защита ключей.

Читать статью
Экономика10 минут

Сколько стоит Telegram-бот на нейросети

Сколько стоит Telegram-бот на нейросети: формула счёта, три сметы от личного бота до поддержки и способы удержать бюджет под контролем.

Читать статью
Агенты4 минуты

Что такое AI Agent: архитектура от модели к инструментам

Что такое AI-агент: цикл perceive-plan-act-observe, ReAct и CoT, механика tool calling, single vs multi-agent и чеклист «это уже агент?».

Читать статью
Агенты3 минуты

Context Engineering: зачем AI-агенту контекст

Context Engineering для AI-агентов: состав контекста, внимание против окна, композиция, ротация и сжатие, кэширование и наблюдаемость.

Читать статью
Протоколы3 минуты

MCP: что это и как агент получает доступ к инструментам

Model Context Protocol: архитектура host-client-server, инструменты-ресурсы-промпты, транспорты, минимальный обмен и поддержка в 2026.

Читать статью
Протоколы3 минуты

MCP Security: главные риски

Безопасность MCP: отравление инструментов, подмена версий, confused deputy, широкие права и защиты — allowlist, approval, песочница, аудит.

Читать статью
Агенты4 минуты

Model Routing: как выбирать модель под задачу

Роутинг моделей: классы, критерии цены и качества, паттерн «простое дешёвой», каскады с fallback и когда роутер окупается. С учётом моделей осени 2026 с маршрут-зависимыми инструментами.

Читать статью
Экономика3 минуты

AI Agent Cost: как считать стоимость workflow

Стоимость AI-агентов: формула с кэшем, почему агент дороже чата, вилка короткой и длинной задач, скрытые статьи и практики экономии.

Читать статью
Агенты3 минуты

AI Observability: что логировать

Наблюдаемость AI: минимальный лог запроса, трассировка шагов агента, что не логировать, метрики, SLO и сверка с биллингом.

Читать статью
Агенты3 минуты

Long-running Agents: архитектура и ограничения

Долгоиграющие агенты: почему ломаются длинные задачи, чекпоинты, план-then-execute, супервизор, дедлайны и идемпотентность повторов. С учётом эпохи агентов 24/7 и генераций на сотни тысяч токенов.

Читать статью
Агенты3 минуты

Subagents: зачем одному агенту другие агенты

Субагенты: изоляция контекста, параллелизм и специализация, цена суммарных токенов, риски координации и правила — глубина, контракты, бюджеты.

Читать статью
Протоколы3 минуты

OpenAI-compatible API: реальная compatibility matrix

Что реально входит в OpenAI-совместимость: ядро из четырёх вещей, 5 мест расхождения, переносимый клиент и чеклист смены модели.

Читать статью
Протоколы3 минуты

AI Gateway: зачем он нужен в 2026

AI Gateway: единый ключ и роутинг, fallback, деньги и лимиты, экономика против прямого аккаунта, риски и чеклист выбора.

Читать статью
Протоколы3 минуты

MCP vs A2A: два уровня agent infrastructure

MCP против A2A: вертикаль к инструментам и горизонталь между агентами, устройство обоих, связка, зрелость на 2026 и выбор.

Читать статью
Практика3 минуты

Генерация видео: цена за секунду и выбор разрешения

Сколько стоит генерация видео: посекундные тарифы по разрешениям, длина ролика, повторы и смета типового кейса.

Читать статью
Практика3 минуты

Генерация изображений: фикс за генерацию

Сколько стоят картинки: фиксированная цена за генерацию, повторы, размер и смета визуального контента.

Читать статью
Практика3 минуты

n8n-автоматизация на AI: глубокий разбор

n8n + AI API всерьёз: отдельный ключ, credentials, идемпотентность, дедупликация, лимиты и разбор типовых зацикливаний.

Читать статью
Практика3 минуты

OpenRouter и агрегаторы: честное сравнение

Чем агрегаторы отличаются от OpenRouter: наценки, рублёвый вход, документы, fallback и методика сравнения на своём usage.

Читать статью
Практика3 минуты

Переезд на NormaHub за вечер

Миграция на NormaHub за вечер: замена base_url, сверка ID, smoke-тест, лимиты, параллельный прогон и откат.

Читать статью
Агенты3 минуты

OpenAI Dots: как устроены always-on AI agents

Архитектура always-on агентов на примере OpenAI Dots: облачный компьютер, персистентный контекст, approvals, фоновый режим и что это меняет для разработчика.

Читать статью
Практика3 минуты

GPT-6.1 Sol: agent workflow через Responses API

Как строить agent workflow на GPT-6.1 Sol: Responses API для инструментов, запрещённые параметры, уровни reasoning и миграция с 6 Sol.

Читать статью
Экономика3 минуты

Prompt caching в GPT-6: breakpoints и диагностика

Как снизить стоимость long-running агентов кэшированием: явные breakpoints, стабильный префикс, диагностика промахов и экономика чтения/записи.

Читать статью
Агенты3 минуты

OpenAI Agents API: long-running агенты в облаке

Как запускать долгоживущих агентов через Agents API: сессии, Codex-harness, окружения, subagents, восстановление — и чем платить за удобство.

Читать статью
Практика3 минуты

Codex Cloud: coding-агент без ноутбука

Облачная модель Codex: переиспользуемые окружения, изолированные workspace, задачи при спящем ноутбуке, ревью и ограничения.

Читать статью
Агенты3 минуты

Gemini 4 Argon: что меняет 1 миллион output tokens

Что меняет лимит генерации в 1M токенов: длинные траектории, экономика выхода, бюджеты, чекпоинты и условия остановки.

Читать статью
Практика3 минуты

Claude Code Mods: плагины, меняющие поведение агента

Архитектура Claude Code Mods: события, порядок ответов, trust boundary, sec-default, supply-chain риски и практика безопасной установки.

Читать статью
Протоколы3 минуты

NVIDIA Open Agent Safety: runtime-граница для агентов

Как строить runtime-границу автономного агента: песочница, политика вне процесса, независимый мониторинг, карантин — модель против рантайма.

Читать статью
Протоколы3 минуты

Google Cloud Remote MCP: gcloud как инструмент агента

Как дать AI-агенту gcloud и BigQuery через удалённый MCP: endpoint, OAuth и IAM, запрещённые команды, least privilege, audit.

Читать статью
Практика3 минуты

Google Cloud Data Agent Kit: данные для coding-агентов

Как coding-агенты получают контекст данных: MCP поверх BigQuery и баз, agent skills, доверенные таблицы, генерация и проверка SQL.

Читать статью
Практика3 минуты

Grok 4.7: почему длинные coding-задачи — отдельный класс

Что меняет Grok 4.7 для coding-агентов: выносливость, самопроверка, цена выходных токенов, уровни reasoning и когда модель окупается.

Читать статью