Перейти к основному содержанию
Для реальных инженерных решений

Руководства по AI-моделям и API

Руководства по AI-моделям, интеграции API и рабочим процессам разработчиков: источники, воспроизводимые шаги и четкие границы для быстро меняющихся цен, квот и возможностей.
  • Приоритет первичных источников
  • Воспроизводимые шаги и границы ошибок
  • Дата проверки изменяемых фактов
  • 467 статей
  • 6 языков
  • 12 тем
  • Обновлено 7 окт. 2026 г.

Общий бюджет, проверяемый прогресс и сверка неизвестной записи перед следующим действием агента
НовоеРуководства по API

Как остановить цикл вызовов инструментов у ИИ‑агента

Зацикливание ИИ‑агента останавливают перед следующим вызовом инструмента. Сохраните причину остановки и состояние операций, затем разрешайте продолжение только после проверяемого изменения условий.

12 мин
Ошибка неподдерживаемой роли в API и выбор подходящего формата сообщений
Руководства по API

Как исправить API 400 с неподдерживаемой ролью и не сломать системные инструкции

Ошибка unsupported role требует проверки конечного запроса: начальные инструкции, правила в середине диалога и результаты инструментов передаются по-разному. Исправляйте формат для своего API, сохраняя приоритет правил и связи в истории.

10 мин
Вызов функции проходит проверку и обработчик приложения, а результат возвращается модели с исходным call_id
Руководства по API

Как перенести вызов функций с Chat Completions на Responses API: полный контур на Python

Для миграции нужно восстановить весь цикл: принять function_call, проверить и выполнить функцию, вернуть function_call_output с тем же call_id и получить завершённый ответ. Пример на Python отделяет запись в приложении от обещания модели.

9 мин
Документ, облачная среда и локальные агенты Codex и Claude Code с разными разрешениями
Инструменты разработчика

Локальные файлы ChatGPT Agent: Work, Codex и Claude Code

Для анализа одного документа достаточно загрузить его в ChatGPT. Для работы с текущей папкой и неотправленными изменениями нужен исполнитель на нужном компьютере: локальный Work, Codex или Claude Code. Чтение файла, запись, команды и управление приложением проверяются отдельно.

13 мин
Схема рабочего контекста, постоянных инструкций и внешних инструментов Claude Code.
Claude Code

Claude Code: контекст, память, MCP и Context7 - сначала чините слой

Начните с /context, чтобы проверить рабочее окно и загрузку инструкций. Через /memory исправьте сохранённые правила, а через /mcp — подключение Context7. Установленный сервер ещё не означает, что документация получена.

9 мин
Связь флага --dangerously-skip-permissions с режимом bypassPermissions и выбор условий для его применения
Claude Code

Claude Code --dangerously-skip-permissions: как включить и что он обходит

Запуск claude --dangerously-skip-permissions включает bypassPermissions: обычные действия инструментов проходят без подтверждения. Флаг --allow-dangerously-skip-permissions только делает этот режим доступным. Правила ask, отдельные защитные проверки и ограничения среды остаются.

11 мин
Схема подключения Claude Code через OpenRouter, напрямую к DeepSeek и через сторонний прокси
Claude Code

Claude Code с OpenRouter и DeepSeek: маршруты, настройка и первые ошибки

Для DeepSeek через OpenRouter задайте адрес OpenRouter, его ключ и модель deepseek/deepseek-v4.1-flash. Для прямого подключения нужны адрес и ключ DeepSeek с моделью deepseek-flash. Проверьте также роли моделей, источник настроек и фактический запрос у провайдера.

11 мин
Варианты настройки строки состояния Claude Code
Claude Code

Claude Code statusline: настройка строки состояния и рабочий скрипт

Для быстрой настройки используйте /statusline, для собственного формата — команду statusLine. Скрипт ниже показывает модель, каталог, ветку Git, занятый контекст и оценку стоимости, сохраняя различие между нулём и отсутствующими данными.

10 мин
Поиск неподдерживаемых параметров в конечном запросе Opus 4.7 с сохранением схем инструментов и повторной проверкой исходной задачи
Claude Code

Claude Code показывает top_p deprecated? Не меняйте route слишком рано, сначала проверьте контракт Opus 4.7

Ошибка top_p deprecated на Opus 4.7 требует убрать параметры выборки там, где формируется конечный запрос. Для Native API и Bedrock Converse это разные поля; исправление проверяют на той же модели и исходной задаче.

9 мин
Варианты подключения Claude к внутренним инструментам и распределение ответственности за выполнение.
Claude и Anthropic

Как подключить Claude к внутреннему API: прямые tools или MCP

Если вызовами управляет ваше приложение, начните с прямых tools Claude API: обработчик проверяет доступ и возвращает результат. MCP оправдан, когда один набор внутренних операций нужен нескольким клиентам; авторизацию и подтверждение действий всё равно реализует ваш сервис.

11 мин
Схема оценки дневных расходов Codex CLI: способ оплаты, токены и бюджет перед длительной задачей
Инструменты разработчика

Стоимость токенов Codex CLI: как оценить дневные расходы API перед долгим запуском

При оплате Codex CLI через OpenAI API стоимость зависит от модели, тарифа, длины каждого запроса и распределения входных токенов. Рассчитайте день по рабочим блокам и оставьте резерв перед продолжением задачи.

12 мин
Проверка источника и полей ошибки Pro: отдельные действия для подтверждённого 503, 504, неизвестного сетевого исхода и нового кода
Руководства по API

Ошибка 503 Nano Banana Pro: что делать при перегрузке и Deadline expired

Если Nano Banana Pro вернул 503, сначала выясните, какой сервис ответил, и проверьте код ошибки. Повторяйте запрос с паузами и установленным пределом, а восстановление подтверждайте готовым изображением. Сообщение Deadline expired само по себе не делает ошибку 504.

9 мин
Два пути Gemini 3.5 Transcribe: отдельные профили записи через Interactions и предварительные/окончательные субтитры Live
Руководства по API

Gemini 3.5 Transcribe API: как расшифровать запись и запустить live-транскрипцию

Запись расшифровывается через Files и Interactions API, субтитры поступают из отдельной Live-модели. Пользовательский словарь и разметка по словам требуют разных конфигураций; предварительный текст потока нужно заменять, окончательный — сохранять.

9 мин
Асинхронная Batch-генерация Gemini 3 Pro Image: половина тарифа, полный бюджет и получение пригодных результатов по ключам
Цены на API и тарифы

Gemini 3 Pro Image Batch API: скидка 50%, расчет стоимости и получение изображений

В официальном Batch API выходное изображение Gemini 3 Pro Image стоит 0,067 USD для 1K/2K или 0,12 USD для 4K по округленной таблице Google. Полный бюджет также включает входные данные, текст и thinking; результаты нужно сопоставлять с запросами по ключам.

9 мин
Схема сравнения Imagen 4 и Nano Banana и подготовки миграции
Генерация изображений

Imagen 4 и Nano Banana: что выбрать после отключения API

Для замены Imagen 4 в Gemini Developer API начните с Nano Banana 2.1. Pro имеет смысл, если сокращает отбраковку и ручные исправления; для Firebase сначала проверьте отдельный список поддерживаемых моделей.

10 мин
Бюджетный шлюз останавливает платный запрос LLM-агента до обращения к провайдеру.
Руководства по API

Kill switch расходов API для LLM-агентов: остановите бюджет до вызова провайдера

Чтобы остановить следующий платный запрос LLM-агента, проверяйте расход вместе с незавершёнными резервами до отправки. Неизвестное списание сохраняйте до сверки, а бюджетный отказ передавайте всем подагентам.

11 мин
Варианты работы небольшой команды: один агент, исполнитель с проверяющим и несколько независимых исполнителей
Инструменты разработчика

Мультиагентная разработка в небольшой команде: worktree, роли и слияние

Несколько ИИ-агентов помогают, когда каждый может закончить свою задачу без незавершённого кода коллеги. Нужны отдельные рабочие каталоги, согласованный интерфейс, передача результата и проверка точного коммита, который команда собирается принять.

13 мин
Подтверждённый 503 проходит ограниченные повторы, исчерпанный бюджет откладывает задачу, а неизвестный сетевой исход требует сверки
Генерация изображений

Nano Banana 2: что делать при ошибке 503 «Model is Overloaded»

При 503 в Nano Banana 2 повторяйте запрос с задержкой и ограничением времени. Если бюджет исчерпан, отложите задачу; успех подтверждайте полученным изображением, а не кодом 200.

8 мин
Настройки JSON или YAML преобразуются в запрос Google Interactions, все целевые изображения сохраняются, а PDF проходит отдельное извлечение и проверку фактов
Руководства по API

Nano Banana Pro API: официальный JSON, YAML, PDF и разбор ошибок

Официальный Nano Banana Pro вызывается как gemini-3-pro-image. Передавайте JSON в Gemini Interactions API, преобразуйте YAML на стороне приложения и сохраняйте изображения из ответа с их MIME. PDF сначала обрабатывается отдельной моделью.

9 мин
Три маршрута Nano Banana Pro и проверка доступа, обратной связи и изображения при текстовом отказе
Генерация изображений

Nano Banana Pro пишет `RESTRICTED by System Instructions`? Сначала проверьте маршрут

Сообщение RESTRICTED by System Instructions само по себе не объясняет отказ. Проверьте доступный путь Pro, повторите допустимую задачу и убедитесь, что вернулось изображение, а не только текст.

10 мин
Nano Banana Pro: повторяемость изображений и способы сохранить визуальное сходство
Генерация изображений

Nano Banana Pro и seed: как повторить изображение и сохранить персонажа

Для точного повторения одобренной картинки сохраняйте сам файл. Для новых сцен используйте референс и список неизменных деталей. Seed есть в общей схеме Gemini API и в отдельных интерфейсах провайдеров, но это не гарантия одинаковых пикселей у Nano Banana Pro.

9 мин