Ръководства за свързване
Подробни ръководства за настройка на SDK, кодиращи агенти, IDE и OpenAI-съвместими клиенти.
Изберете клиента, който използвате:
- Claude Code
- Codex CLI
- Cursor IDE
- GitHub Copilot
- OpenCode
- Cline
- LibreChat
- OpenAI SDK
- Anthropic SDK
- Замяна на крайна точка в Windows и Linux (mitmproxy)
Създайте API ключ в Модел Gate контролен панел. Пълният ключ се показва само веднъж.
Достъп до детска площадка
отворено Детска площадка в менюто на акаунта, за да използвате Request builder или Model Verification. В бизнес профилите разделът остава видим, докато API на модела е активиран, дори когато все още не е зададен използваем ключ. Страница за настройка обяснява липсващата проверка на акаунта, активиране на фирма, разрешения за ключове или конфигурация на крайна точка на API и предлага разрешени връзки за управление и поддръжка. Простото отваряне на Playground не прави платена заявка и не създава ключ.
Заявките изискват разрешен активен ключ. Обвързаният с проект ключ трябва да принадлежи на текущата компания и активен проект. С достъп за изпълнение на програмист или администратор член може да използва споделени идентификационни данни за проект в Playground, без да получава неговата постоянна тайна. Сесията на браузъра представлява влезлия член, а не пазителя на ключа; гледането само на използване не дава изпълнение. Когато API на модела е деактивиран за домейн, неговите маршрути за Playground също не са достъпни. Временната парола и необходимата двуфакторна настройка все още имат предимство.
Панелът използва конфигурираната крайна точка на API на своя текущи профил на домейн. Той не превключва към API на друг проект, когато липсва обвързване. Селекторът на ключове показва използването, което може да се нулира, спрямо конфигурирания лимит на разходите; разходът през целия живот не е този брояч. Текущите лимити за ключове/проекти и балансът на компанията се проверяват преди издаване на краткотрайна сесия, а API остава авторитетен за приемане на живо и таксуване. Замразяване на проект или промяна на разрешението след зареждане на страницата може да направи предварително избрания ключ недостъпен; опресняване на страницата след оторизирана корекция.
Мултимодални формати на заявки
Builder следва същите договори за възможности, използвани от сондажите на администраторския модел. OpenAI-съвместимо генериране на изображения използва /v1/responses с хостваното image_generation инструмент; генерираното image_generation_call.result се декодира и показва като артефакт на изображението. OpenAI Responses PDF въвеждането използва an input_file т. съдържание с пълно data:application/pdf;base64,... стойност в file_data. Въвеждането на PDF антропни съобщения използва роден document блокирайте с source.type=base64, media_type=application/pdf и голата база64 байта. Браузърът чете избрани файлове локално и ги изпраща директно към конфигурираната крайна точка на API на модела; панелът не ги качва първо. Builder не рекламира завършвания на чат като PDF формат. Необработеният JSON остава достъпен за специфични за доставчика договори извън тези тествани форми.
Проверка на модела на браузъра
/chat/verify сравнява крайна точка с готова поведенческа справка на избрания каноничен модел. Настоящият метод е model-verification-behavioral-reference-v2.0. Това не е атестация на доставчик или твърдение относно записите за обучение.
Готова справка, без етап на проучване
Администраторите поотделно активират платен колектор на референтни данни, използвайки изрично доверен маршрут. Той чете готови месеци от съществуващата банка с въпроси, с десет преценени наблюдения на въпрос по подразбиране и до двадесет отделни въпроса на искане за събиране. Грешките на доставчика и неоценените/липсващите отговори не са наблюдения на невежество. Административните отговори и ревизии се запазват за проверка; потребителските изпълнения никога не допринасят автоматично за тази надеждна справка.
Справката трябва да обхваща шестнадесет последователни завършени месеца от двете страни на стабилна наблюдавана котва RECALL. Два отговарящи на условията факта се избират на месец, като се предпочита един обикновено правилен и един обикновено неверен факт, когато и двата съществуват; иначе две от наличната стабилна категория. Съдията трябва да приеме покана за контрол на формат с 32 въпроса, преди препратката да стане готова. Активираното автоматично събиране го поставя на опашка под споделеното разрешение за извикване на API; старите ръчни профили запазват своето изрично контролно действие. Официалните метаданни за прекъсване остават отделни. Непубликувано официално прекъсване никога не задейства проучване по време на потребителско изпълнение. Липсата на готов справочник или непълното покритие означава, че моделът все още не може да бъде тестван.
Една тествана заявка и един съдия на преден план
Изберете готова референция и отговарящ на условията ключ за порта за модел за таксуване за оценка. Справката закрепва протокола, каноничния модел и точния договор за заявка. Използване на нови автоматични препратки minimal-v1: Chat изпраща само модел + едно потребителско съобщение, Responses само модел + вход, а Anthropic Messages допълнително изпраща необходимите max_tokens=4096. Историческите справки запазват своите запазени наследени опции. Браузърът прави една заявка с 32 въпроса към избраната от вас HTTPS крайна точка. Външният ключ остава само в паметта на браузъра; той никога не се изпраща до сървъра за приложения на Model Gate или се съхранява в локално/сесийно хранилище. CORS трябва да разреши тази заявка на браузъра. Тестваният модел получава въпроси и инструкции от затворена книга, никога ключ за отговор, референтни отговори, положителни/отрицателни етикети или очаквани грешки.
В този жизнен цикъл няма търсене на прекъсване, хоствано търсене, банково население или генериране на въпроси. Локалният избор на моментна снимка не е платено повикване за генериране. Външният доставчик може да таксува своята заявка; съдията на преден план използва избраните отговарящи на условията идентификационни данни за Model Gate. Дръжте раздела отворен. Индикаторът на сцената на живо показва изминалото време и действителната работа; докато проверката е активна, браузърът предупреждава преди затваряне, презареждане или навигация. Това не продължава заявката във фонов режим. Повторният опит за непълна оценка използва отговора, който все още се съхранява в браузъра, а не втора заявка за тестван модел. Несигурно повикване не се възпроизвежда автоматично.
Браузърът предава директно заявката за отговори на съдия на преден план api.model-gate.com, без хоствано търсене. Многоминутният съдийски поток не се поддържа отворен panel.model-gate.com. Автоматичните проверки на формата и старият резултат за следване на инструкции остават изключени; семантичната оценка принадлежи изключително на съдията.
Кореспонденция само за съдия
Съдията получава текущите отговори, верните отговори и всички групирани референтни наблюдения за избраните 32 факта, включително противоречиви наблюдения и тяхната множественост. Оценява коректността, декларираното ПРИПОМНЯНЕ/ИЗВОД/ПРЕДПОЛАГАНЕ/НЕИЗВЕСТНО поведение и отклонения в двете посоки. Неочаквани правилни отговори на обикновено неразрешени справочни въпроси могат да намалят кореспонденцията; действителните верни отговори не се обозначават отново като грешни. Съдията сам определя оценката за съответствие, категорията за оценка на самоличността, доверието, причините и ограниченията. Сървърът валидира структурата на отчета и брои запазените наблюдения, но не прилага семантичен праг, наказание, претеглен резултат или заместващо заключение.
Високият резултат не е вероятност за точна идентичност на модела. Докладът не може да установи цената на модела или датата на обучение. Съхранената моментна снимка и бенчмарк идентифицират точно какво е сравнено. Старите отчети v1.7 запазват оригиналния си метод и не се обединяват с доказателства v2. Не се изчислява автоматична значка за идентичност на общността от резултати v2.
Доклади и поверителност
Проследяването на живо показва заявката, отговора, задържан от браузъра, полезен товар за оценка и резултат от съдия без идентификационни данни. Частното изпълнение не запазва пълния необработен отговор на доставчика или дословния видим отговор на въпрос за възстановяване на браузъра; нормализираните оценки, обясненията и неизменните референтни идентификатори остават. Публикуването е отделно изрично включване. Публикуваните отчети v2 показват запазеното заключение на съдията, без да се извършва друга оценка или оценяване от страна на сървъра. Административните справочни отговори имат свой собствен запазен/одитиран жизнен цикъл, за разлика от обикновените отговори на браузъра.
Заявка за съвместимост и грешки на доставчика (10.28.1)
Заявката за потвърждение на Chat Completions поставя пълните инструкции от затворена книга и всички въпроси, подредени в едно потребителско съобщение. Това избягва изискването на OpenAI-съвместим шлюз за превод на системна роля, когато тя насочва към бекенд в стил Anthropic. Избраният протокол и точната крайна точка остават авторитетни: няма превключване на протокол, базиран на име на модел, заявка за допълнително тестван модел или прокси преобразуване с общо предназначение. Native Anthropic Messages все още използва най-високо ниво system с потребителско съобщение; Responses retains its canonical user input. The trace shows the actual outbound JSON. Установената транспортна съвместимост се запазва. Behavioral-reference v2 доставя фиксирана заявка от 32 въпроса, без да променя правилото за заявка за един тестван модел.
Отговорите, които не са 2xx, са HTTP грешки, а не неразпознати успешни пликове. Грешка на основния доставчик се съобщава като Плик за грешка на доставчика, дори когато се връщат с HTTP 200. Такива грешки никога не предоставят отговори на модела, никога не достигат оценка от съдия и не могат да бъдат поправени чрез оценка на повторен опит на същия отговор. Съвместимостта на протокола е NOT_ASSESSED за отговор за грешка. Всяка изпълнена външна заявка все още може да бъде таксувана; локалният референтен избор не прави извикване на генератор. Необработените грешки на доставчика остават локална диагностика в браузъра, а не публично съдържание на отчета. Обща грешка нагоре по веригата на Model Gate умишлено не разкрива необработеното съобщение нагоре по веригата само за администратор.
Автоматично администриране на справки
Администраторите конфигурират автоматично събиране на справки веднъж за отговарящи на условията съществуващи и бъдещи каталожни модели. Използват се конфигурираната API връзка на Model Gate и администраторският ключ със споделени дневни/доживотни ограничения за API-повиквания и без отделен автоматичен бюджет за резервация в USD. Моделите се нуждаят от официална граница или неофициална оценка с отделни източници, за да закотвят събирането; работникът не проучва липсващи дати или генерира въпроси. Първоначалната настройка по подразбиране остава десет използваеми наблюдения на въпрос и най-много двадесет различни въпроса на искане за събиране. Наследените ръчни препратки остават отделни.
Препратката е доказателство за конфигурирано поведение, а не доказателство за това кой доставчик е изпълнил заявка. Недопустимите или двусмислените маршрути остават недостъпни, докато администраторът не разреши маршрутизирането. Само съдията оценява кореспонденцията.
Неподдържаните API пътища вече се връщат 404 endpoint_not_supported с искания път; връща се грешен метод по поддържан път 405 method_not_allowed и Allow. Роден /v1/balance е непроменена; /v1/user/balance не се изпълнява. Споделяйте върнатия ID на заявката, никога вашия API ключ, когато докладвате за тези грешки.