API управления ресурсами компании

Используйте Partner API с доверенного сервера для управления ключами компании и сверки активности аккаунта. Стандартный адрес — https://p-api.b2b-llm.com. Он отличается от адреса запросов к моделям и не использует интерактивный браузерный сеанс.

Граница авторизации

Подтверждённый владелец компании создаёт ключ mg_partner_... в профиле. Сохраните полное значение при создании или перевыпуске; для обычного управления остаются только хеш и отображаемый префикс. Ключи Model API сотрудников не разрешают управление ресурсами владельца.

Authorization: Bearer mg_partner_...
Accept: application/json

При наличии применяются и корпоративные, и личные API-ограничения IP. Не раскрывайте токен Partner API в расширении редактора, клиентской сборке или общей конфигурации чата.

Надёжные изменения

POST, PATCH и DELETE требуют Idempotency-Key. Каждая логическая операция получает свой ключ. При неизвестном транспортном результате повторите метод, путь и тело с исходным ключом; зашифрованный результат операции хранится семь дней. Повторное использование ключа для другой операции возвращает 409, а не меняет прежний результат.

Стандартный лимит управления — 600 операций в минуту на аккаунт; оператор может его изменить. Читайте заголовки лимитов и соблюдайте Retry-After, не повторяйте запросы непрерывно. Ошибки JSON, X-Request-ID и Cache-Control: no-store применяются также к неподдерживаемым методам и отсутствующим ресурсам.

Значения и записи

Передавайте денежные величины десятичными строками и сохраняйте точность. Ключи, проекты и запросы адресуются публичными ID, не числовыми ID БД. Время — UTC RFC3339. Коллекции используют непрозрачные курсоры; следуйте им, не декодируя и не выдумывая позиции.

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

Business-ключи, созданные через Partner API, используют владельца как пользователя ключа. Явно переданный проект должен принадлежать компании и быть активным. Назначение сотрудника — операция рабочей области аккаунта, не произвольное поле личности запроса Partner API.