Перейти к содержимому
MGModel Gate
ВойтиНачать работу

Инструкции подключения

Подробная настройка SDK, агентов программирования, IDE и OpenAI-совместимых клиентов.

Выберите используемый клиент:

Создайте API-ключ в панели Model Gate. Полный ключ показывается только один раз.

Доступ к Playground

Откройте Playground в меню аккаунта для Request builder или Model Verification. В Business-профилях раздел остаётся видимым при включённом Model API, даже если пригодный ключ ещё не назначен. Страница настройки объясняет отсутствие подтверждения аккаунта, активации компании, прав ключа или настройки эндпоинта API и предлагает разрешённые ссылки управления и поддержку. Само открытие Playground не делает платного запроса и не создаёт ключ.

Запросам нужен разрешённый активный ключ. Ключ проекта должен принадлежать текущей компании и активному проекту. При праве выполнения developer или administrator участник может использовать общий ключ проекта в Playground, не получая его постоянный секрет. Браузерный сеанс представляет вошедшего участника, а не хранителя ключа; право просмотра использования не даёт права выполнения. При отключении Model API для домена его маршруты Playground также недоступны. Требования временного пароля и настройки второго фактора по-прежнему имеют приоритет.

Панель использует настроенный эндпоинт API своего текущего профиля домена. При отсутствии связи она не переключается на API другого проекта. Выбор ключа показывает обнуляемое использование относительно настроенного лимита расходов; расходы за весь период — другой счётчик. Перед выдачей короткого сеанса проверяются текущие лимиты ключа и проекта и баланс компании; окончательный допуск и расчёт выполняет API. Заморозка проекта или изменение прав после загрузки страницы может сделать выбранный ключ недоступным; после разрешённого исправления обновите страницу.

Форматы мультимодальных запросов

Builder предлагает форматы ввода, поддерживаемые выбранной моделью. OpenAI-совместимая генерация изображений использует /v1/responses со встроенным инструментом image_generation; image_generation_call.result декодируется и показывается как изображение. PDF-ввод OpenAI Responses использует элемент содержимого input_file с полным значением data:application/pdf;base64,... в file_data. PDF-ввод Anthropic Messages использует собственный блок document с source.type=base64, media_type=application/pdf и непосредственно байтами base64. Браузер читает выбранные файлы локально и отправляет прямо в настроенный Model API; предварительной загрузки в панель нет. Builder не предлагает Chat Completions как формат PDF. Raw JSON остаётся доступным для контрактов поставщиков за пределами этих проверенных структур.

Совместимые варианты запроса

В Request builder сначала выберите тип запроса, чтобы увидеть совместимые модели. Варианты протокола, эндпоинта и Streaming зависят от заявленных возможностей модели и проверок конкретного протокола; проверка одного семейства API не считается доказательством для другого. Совместимые модели Claude по умолчанию используют Anthropic Messages. Явные ограничения эндпоинтов сохраняются, а Raw JSON доступен для осознанного выбора протокола и тела. Совместимость в каталоге не гарантирует доступность прямо сейчас.

Под отключённой кнопкой Send объясняется, чего не хватает: выберите ключ и модель, укажите обязательный промпт или файл, исправьте структуру запроса или лимит токенов либо дождитесь текущей отправки. Смена типа запроса может выбрать другую совместимую модель. Vision и вызовы функций используют структуру выбранного семейства API; PDF не отправляется через Chat Completions. Эти варианты не меняют отдельный контракт эталонов Model Verification.

Проверка модели

/chat/verify сравнивает эндпоинт с готовым поведенческим эталоном выбранной канонической модели. Текущая методика — model-verification-behavioral-reference-v2.0. Это не аттестация поставщика и не утверждение о данных обучения.

Готовый эталон без исследовательского этапа

Готовый эталон содержит сохранённые наблюдения за шестнадцать последовательных завершённых месяцев вокруг наблюдаемой границы RECALL. Проверка выбирает по два факта на месяц — всего 32 вопроса. Ответы сравниваются с сохранёнными наблюдениями; сведения об обучении не проверяются. Официальные метаданные границы знаний — отдельная сообщённая дата. Вопросы берутся из сохранённого банка. Ошибки поставщика и отсутствующие или неоценённые ответы не считаются наблюдениями незнания. Запуск проверки не исследует даты, не генерирует вопросы и не готовит эталон. Если готового эталона модели нет, выберите другую доступную модель или обратитесь в поддержку.

Одна серверная задача, один запрос к модели и один оценщик

Выберите готовый эталон и подходящий ключ Model Gate для оплаты оценки. Эталон фиксирует протокол, каноническую модель и точный контракт запроса. Новые автоматические эталоны используют minimal-v1: Chat отправляет только model и одно пользовательское сообщение, Responses — model и input, Anthropic Messages дополнительно передаёт обязательный max_tokens=4096. Исторические эталоны сохраняют прежние параметры. Серверный worker делает один запрос с 32 вопросами к выбранному HTTPS-эндпоинту. Проверяемая модель получает вопросы и инструкции отвечать без внешних источников, но не правильные ответы, эталонные наблюдения, положительные/отрицательные метки или ожидаемые ошибки.

Браузер отправляет задачу в панель и читает сохранённый прогресс. Прямых обращений к внешнему эндпоинту или оценщику нет, поэтому их браузерные CORS-политики не участвуют. Можно закрыть или обновить страницу и открыть запуск из недавней истории. Просмотр и переподключение не создают платных запросов. Если подтверждение создания потерялось, используйте восстановление той же отправки; не создавайте новый запуск для обхода неизвестного исхода.

Внешний ключ передаётся панели по HTTPS, временно хранится зашифрованным для worker и удаляется после сохранения внешнего ответа или завершения задачи. Он не помещается в local/session storage браузера и не возвращается в статусе. Приватные исходные ответы зашифрованы и доступны только владельцу до 24 часов с создания задачи. Новые этапы обращения к поставщику не начинаются позднее одного часа после создания. Перед отправкой повторно проверяются аккаунт, ключ, компания, домен и ограничения расходов. Ключ Model Gate с IP-ограничением должен разрешать фактический исходящий адрес сервера worker.

В этом процессе нет поиска границы знаний, встроенного поиска, наполнения банка или генерации вопросов. Локальный выбор снимка не является платной генерацией. Внешний поставщик может тарифицировать свой запрос; оценщик использует выбранный подходящий ключ через настроенный API Model Gate. Сохранённый ответ обрабатывается после восстановления worker без нового запроса к проверяемой модели. Если запрос отправлен, но полный ответ не сохранён, задача останавливается с неизвестным исходом без автоматического повтора. Отмена предотвращает следующий этап; уже отправленный запрос может завершиться и тарифицироваться. Автоматические проверки формата и прежняя оценка Instruction Following исключены; смысловую оценку выполняет только оценщик.

Соответствие определяет только оценщик

Оценщик получает текущие и правильные ответы, а также все сгруппированные эталонные наблюдения по выбранным 32 фактам, включая противоречия и число повторений. Он оценивает правильность, заявленное поведение RECALL/INFERENCE/GUESS/UNKNOWN и отклонения в обе стороны. Неожиданные правильные ответы на обычно не решаемые эталоном вопросы могут снизить соответствие; фактически верные ответы не помечаются неверными. Только оценщик назначает балл соответствия, категорию определения модели, уверенность, причины и ограничения. Сервер проверяет структуру отчёта и считает сохранённые наблюдения, но не применяет смысловой порог, штраф, взвешенную оценку или замену вывода.

Высокий балл не является вероятностью точного совпадения модели. Отчёт не устанавливает цену модели или дату её обучения. Сохранённый снимок и набор тестов точно определяют сравнение. Прежние отчёты v1.7 сохраняют свою методику и не смешиваются с данными v2. Автоматический значок подтверждения модели сообществом по баллам v2 не рассчитывается.

Отчёты и конфиденциальность

Приватный журнал показывает фактический запрос, сохранённый внешний ответ, данные для оценщика и его вывод без ключей. Исходные ответы доступны владельцу в течение 24 часов; затем остаются нормализованные оценки, объяснения и неизменяемые идентификаторы эталона. Исторические браузерные запуски сохраняют отчёт и причину остановки и никогда автоматически не возвращаются в очередь. Публикация требует отдельного явного согласия. Публичные отчёты v2 показывают сохранённый вывод оценщика без новой оценки или серверного пересчёта; согласие на публикацию полного отчёта включает публикуемый ответ модели. Приватные записи ответов задачи не выдаются публичным API задачи.

Совместимость запроса и ошибки поставщика (10.28.1)

Запрос проверки Chat Completions помещает все инструкции ответа без внешних источников и вопросы по порядку в одно пользовательское сообщение. Это не требует от OpenAI-совместимого шлюза перевода системной роли при маршрутизации в Anthropic-подобный сервер. Выбранный протокол и точный эндпоинт остаются определяющими: нет смены протокола по имени модели, дополнительного запроса к проверяемой модели или универсального преобразования прокси. Нативный Anthropic Messages по-прежнему использует верхнеуровневый system и пользовательское сообщение; Responses сохраняет канонический пользовательский ввод. Журнал показывает фактический исходящий JSON. Установленная транспортная совместимость сохраняется. Поведенческий эталон v2 задаёт фиксированный запрос из 32 вопросов, не меняя правило одного обращения к проверяемой модели.

Ответы вне 2xx — HTTP-ошибки, а не нераспознанные успешные оболочки. Корневая ошибка поставщика показывается как Provider error envelope, даже при HTTP 200. Такие ошибки не содержат ответов модели, не передаются оценщику и не исправляются повтором Retry evaluation для того же ответа. Для ответа с ошибкой совместимость протокола — NOT_ASSESSED. Любой выполненный внешний запрос всё равно может тарифицироваться; локальный выбор эталона не вызывает генератор. Исходные ошибки поставщика остаются в зашифрованном журнале задачи, доступном владельцу в пределах срока хранения, и не входят в публичный отчёт. Общая ошибка Model Gate может скрывать конфиденциальные подробности поставщика. Передавайте поддержке ID запроса, а не ключ или закрытый ответ.

Неподдерживаемые пути API возвращают 404 endpoint_not_supported с запрошенным путём; неправильный метод поддерживаемого пути — 405 method_not_allowed и Allow. Нативный /v1/balance не изменён; /v1/user/balance не реализован. При сообщении об ошибке передавайте возвращённый ID запроса, а не API-ключ.

Контакты поддержки в партнёрском Telegram-боте

В Affiliates → Your Telegram bots при подключении бота можно задать Support Telegram и Support email. Оба поля необязательны. Telegram принимает @username или HTTPS-ссылку контакта/приглашения t.me; email принимает обычный адрес электронной почты.

Для существующего бота разверните Support contacts, измените поля и нажмите Save support contacts. Каждое пустое поле использует текущий стандартный контакт соответствующего канала. Очистите оба поля для возврата всех стандартных контактов. Старые боты без собственной настройки автоматически продолжают использовать значения по умолчанию.

Клиенты видят действующие контакты через Help, /help или /support в этом боте. Команды поддержки доступны и до регистрации. Контакты относятся только к принимающему боту: они не меняют сайт Model Gate, других ботов, официальные уведомления аккаунта или внутренних получателей обращений. Сохранение не требует повторного ввода токена бота, не переустанавливает вебхук и не включает отключённого бота.

Отдельная вкладка Images

Откройте Playground Images, третью вкладку рядом с Request builder и Model Verification, для генерации и редактирования по проверенным маршрутам, подтверждения цены, истории и закрытых скачиваний. Она использует отдельное разрешение на одно намерение и не меняет непосредственный запрос конструктора или отдельную серверную очередь проверки.

Границы интеграции

Эти инструкции клиентов описывают настроенные в репозитории текстовые и агентные интерфейсы, а не гарантируют поддержку долговременных операций Images актуальным сторонним выпуском. Автоматические клиентские повторы потенциально платного POST требуют отдельной проверки. Для генерации/редактирования используйте документированные Idempotency-Key, расчёт цены, опрос операции и получение файлов с аутентификацией; примеры SDK не подтверждают автоматически совместимость async или изображений. Установленную версию клиента проверяйте отдельно.

Для записей используйте Playground Audio и API транскрибации. Audio отделён от текстового чата и Images.

Рабочая область Video

Playground → Video предоставляет расчёт цены text-to-video, прогресс, воспроизведение сохранённого MP4, частное скачивание и Raw/cURL. Используйте доступную модель и маршрут выбранного ключа; новая платная операция не является повтором с неизвестным исходом.