Перейти к основному содержанию

Руководства по API

Пошаговые руководства по интеграции AI API: получение и защита ключей, авторизация, эндпоинты и SDK, OpenAI-совместимая настройка и приёмы для продакшена.
  • 73 статьи
  • Обновлено 10 окт. 2026 г.
Вызов функции проходит проверку и обработчик приложения, а результат возвращается модели с исходным call_id

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

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

9 мин
Grok Voice Agent API: схема пути от реплики и WebSocket-сессии до голосового ответа в WAV

Grok Voice Agent API: подключение по WebSocket, звук, цена и аутентификация

Grok Voice Agent API работает через wss://api.x.ai/v1/realtime. Для первого голосового ответа настройте PCM 24 кГц, отправьте реплику и соберите аудиособытия в WAV. Сервер использует API-ключ, браузер — временный токен; 0,08 USD/мин рассчитываются по длительности сессии при VAD и по аудио при ручном управлении.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

9 мин
Различие между ошибкой соединения с OpenAI API и полученным HTTP-ответом

Ошибка подключения OpenAI API: сначала проверьте маршрут APIConnectionError

При openai.APIConnectionError: Connection error сначала сохраните исходное исключение и проверьте соединение из неработающего процесса. Отдельно разберите DNS, TLS, прокси и адрес API, а после исправления повторите исходный вызов с ограниченной нагрузкой.

9 мин
Разделение причин ошибки квоты OpenAI API: баланс, расходы, организация и проект

Ошибка OpenAI API quota exceeded: как проверить баланс и лимиты

Если OpenAI API возвращает quota exceeded или insufficient_quota, начните с error.code: он отличает пустой баланс от месячного ограничения. После исправления проверяйте тот же проект и модель — квитанция об оплате сама по себе не подтверждает восстановление запросов.

7 мин
Текстовая транскрибация и голосовой диалог решают разные задачи; Realtime, GPT-Live и STT–LLM–TTS сравниваются по полному расходу на завершённый результат

OpenAI Realtime API или STT → LLM → TTS: как сравнить полную стоимость

Для расшифровки начните с транскрибации; для разговора сопоставьте Realtime, GPT-Live и всю цепочку STT → LLM → TTS. Недорогой Realtime mini может изменить выбор, а стоимость минуты звонка зависит от того, какой счётчик её измеряет.

12 мин
Два пути получения ответа: готовый объект и запрос инструмента с исполнением в приложении

Structured Outputs или Function Calling в OpenAI: что выбрать

Structured Outputs задаёт форму ответа, а Function Calling передаёт приложению запрос на работу. Строгие аргументы функции тоже используют Structured Outputs; выбор зависит от того, нужны ли внешние данные и кому предназначен финальный объект.

8 мин