Интеграции

Подключите инструменты, которые ваша команда уже использует.

Один раз направьте совместимые клиенты и API-процессы на New API. Сохраняйте привычные инструменты, пока ваша организация контролирует доступ к моделям, использование и расходы.

Перед подключением

Сначала подготовьте путь доступа.

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

Назначьте владельца

Назначьте владельца рабочего пространства или проекта, который может одобрять модели, проверять использование и реагировать, когда запрос заблокирован.

Одобрите модель

Проверьте каталог моделей и убедитесь, что возможность, контекст и маршрут провайдера подходят для предполагаемого процесса.

Установите квоту

Задайте ключу или команде явную границу использования до подключения общего редактора, агента или сервиса.

Совместимые клиенты

Единый управляемый маршрут для повседневной работы с AI.

Используйте New API из редактора, терминала или совместимого API-клиента, подходящего для процесса.

VS Code

Сценарии AI в редакторе

Codex

Рабочие процессы агентов и терминала

Claude Code

Сценарии, совместимые с Anthropic

Trae

Редакторские процессы с приоритетом AI

Zcode

Сценарий помощника программиста

Совместимые клиенты

Конфигурация, совместимая с OpenAI

Настройте внимательно

Сохраняйте предсказуемость учётных данных и поведения запросов.

Интеграция должна быть простой для тестирования разработчиком и удобной для проверки администратором.

Используйте серверный ключ

Храните API-ключ New API в переменной окружения или менеджере секретов. Никогда не размещайте его в браузерном коде, репозитории или журналах запросов.

Подберите формат запроса

Выберите конечную точку, соответствующую семейству моделей, затем укажите идентификатор модели и обязательные поля в теле запроса.

Протестируйте небольшой запрос

Начните с репрезентативного запроса малого объёма. Подтвердите ответ, запись об использовании, поведение квот и обработку ошибок до внедрения.

Оркестрация агентов

Позвольте агентам вызывать инструменты через единый управляемый маршрут.

Агент может планировать задачу, извлекать контекст и вызывать одобренную модель, пока New API удерживает учётные данные, доступ к моделям и историю запросов под едиными операционными правилами.

Запрос задачи

Агент

Извлечение контекста

Вызов модели

Проверенный результат

Понятный путь интеграции

От настройки к управляемому результату.

Выберите одобренную модель

Выберите модель и возможность, которые ваша организация сделала доступными.

Настройте совместимую конечную точку

Настройте клиент с конечной точкой New API и управляемым API-ключом.

Оценивайте использование в контексте

Используйте журналы запросов, квоты и данные об использовании до расширения доступа.

FAQ по интеграции

Практичные ответы до запуска в эксплуатацию.

Используйте эти ответы для планирования первого подключения. Справочник API остаётся источником истины для полей конечных точек и поведения конкретных провайдеров.

С чего нам начать?

Начните с одного процесса с владельцем, одной одобренной модели и одного тестового ключа. Подключите его в среде, отличной от производственной, проверьте ответ и запись об использовании, затем расширяйтесь осознанно.

Как выбрать базовый URL и конечную точку?

Используйте базовый URL New API, предоставленный для вашего рабочего пространства, и выберите совместимую конечную точку для семейства моделей. В справочнике API перечислены актуальные пути, обязательные заголовки и поля запроса.

Где должен храниться API-ключ?

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

Взаимозаменяемы ли форматы OpenAI, Anthropic и Gemini?

Они не взаимозаменяемы для каждой модели. New API поддерживает совместимые форматы там, где это применимо, включая Chat Completions, Responses, Anthropic Messages и Gemini GenerateContent. Перед сменой формата ознакомьтесь с документацией по модели и конечной точке.

Как узнать, какие модели доступны?

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

Что делать с ошибками 401, 403, 404 или 429?

Проверьте ключ и заголовок для 401, разрешения или доступ к модели для 403, путь и совместимость модели для 404, квоту или ограничения скорости для 429. Сохраните идентификатор запроса и обратитесь к справочнику API или в поддержку при постоянных сбоях.

Как обрабатывать лимиты в производственной среде?

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

Когда следует читать справочник API?

Используйте его, когда нужны точные пути конечных точек, заголовки, схемы запросов, поведение потоковой передачи, поля медиа или ограничения конкретного провайдера. Эта страница описывает процесс интеграции; справочник определяет контракт.