Guies de connexió
Guies de configuració detallades per a SDK, agents de codificació, IDE i clients compatibles amb OpenAI.
Trieu el client que feu servir:
- Claude Code
- Codex CLI
- Cursor IDE
- GitHub Copilot
- OpenCode
- Cline
- LibreChat
- OpenAI SDK
- Anthropic SDK
- Substitució del punt final a Windows i Linux (mitmproxy)
Creeu una clau API al fitxer Panell de control Model Gate. La clau completa només es mostra una vegada.
Accés al parc infantil
Obert Parc infantil al menú del compte per utilitzar el creador de sol·licituds o la verificació del model. Als perfils empresarials, la secció roman visible mentre l'API Model està activada, fins i tot quan encara no s'ha assignat cap clau utilitzable. Una pàgina de configuració explica la falta de verificació del compte, l'activació de l'empresa, els permisos clau o la configuració del punt final de l'API i ofereix enllaços de gestió i assistència permesos. Només obrir Playground no fa cap sol·licitud de pagament i no crea cap clau.
Les sol·licituds requereixen una clau activa permesa. Una clau vinculada al projecte ha de pertànyer a l'empresa actual i un projecte actiu. Amb accés a l'execució de desenvolupador o administrador, un membre pot utilitzar una credencial de projecte compartida a Playground sense rebre el seu secret permanent. La sessió del navegador representa el membre que ha iniciat la sessió, no el custodi de la clau; l'ús de visualització per si sol no garanteix l'execució. Quan l'API Model està desactivada per a un domini, les seves rutes Playground tampoc no estan disponibles. La contrasenya temporal i la configuració necessària de dos factors encara tenen prioritat.
El tauler utilitza el punt final de l'API configurat del seu perfil de domini actual. No canvia a l'API d'un altre projecte quan falta una vinculació. El selector de claus mostra l'ús que es pot reiniciar amb el límit de despesa configurat; la despesa de tota la vida no és aquest comptador. Els límits actuals de claus/projectes i el saldo de l'empresa es comproven abans d'emetre una sessió de curta durada, i l'API continua sent autoritat per a l'admissió i la facturació en directe. Una congelació del projecte o un canvi de permís després de la càrrega de la pàgina pot fer que la clau seleccionada anteriorment no estigui disponible; Actualitzeu la pàgina després d'una correcció autoritzada.
Formats de sol·licitud multimodal
El Builder segueix els mateixos contractes de capacitat que utilitzen les sondes de models d'administrador. Usos de generació d'imatges compatibles amb OpenAI /v1/responses amb l'acollida image_generation eina; el generat image_generation_call.result es descodifica i es mostra com un artefacte d'imatge. L'entrada de PDF OpenAI Responses utilitza un input_file element de contingut amb un complet data:application/pdf;base64,... valor en file_data. Missatges antròpics L'entrada en PDF utilitza un nadiu document bloc amb source.type=base64, media_type=application/pdf i la base nua de 64 bytes. El navegador llegeix els fitxers seleccionats localment i els envia directament al punt final de l'API del model configurat; el panell no els carrega primer. El Builder no anuncia les finalitzacions de xat com a format PDF. El JSON en brut continua disponible per a contractes específics del proveïdor fora d'aquestes formes provades.
Verificació del model del navegador
/chat/verify compara un punt final amb un ready referència conductual del model canònic seleccionat. El mètode actual és model-verification-behavioral-reference-v2.0. No és una certificació del proveïdor ni una reclamació sobre els registres de formació.
Referència a punt, sense fase d'investigació
Els administradors habiliten per separat un col·lector de referències de pagament mitjançant una ruta de confiança explícita. Llegeix mesos preparats del banc de preguntes existent, amb deu observacions jutjades per pregunta per defecte i fins a vint preguntes diferents per sol·licitud de recollida. Els errors del proveïdor i les respostes no qualificades/faltes no són observacions d'ignorància. Les respostes administratives i les revisions es conserven per a la seva inspecció; Les execucions d'usuari mai contribueixen a aquesta referència de confiança automàticament.
Una referència ha de cobrir setze mesos consecutius completats a banda i banda d'un ancoratge RECALL observat estable. Es seleccionen dos fets elegibles per mes, preferint un fet normalment correcte i un fet normalment no correcte quan tots dos existeixen; en cas contrari dos de la categoria estable disponible. El jutge ha d'acceptar una trucada de control de format de 32 preguntes abans que la referència estigui llesta. La recollida automàtica activada la posa a la cua sota l'autorització de trucada de l'API compartida; els perfils manuals heretats conserven la seva acció de control explícita. Les metadades oficials de tall romanen separades. Un tall oficial no publicat mai activa la recerca durant l'execució d'un usuari. Cap referència preparada o cobertura incompleta significa que el model encara no es pot provar.
Una sol·licitud provada i un jutge de primer pla
Seleccioneu una referència preparada i una clau Model Gate apte per a la facturació d'avaluació. La referència fixa el protocol, el model canònic i el contracte de sol·licitud exacta. Nou ús de referències automàtiques minimal-v1: El xat només envia el model + un missatge d'usuari, només el model de respostes + l'entrada i els missatges antròpics també envia max_tokens=4096 necessaris. Les referències històriques conserven les seves opcions heretades desades. El navegador fa una sol·licitud amb 32 preguntes al punt final HTTPS seleccionat. La clau externa només roman a la memòria del navegador; mai s'envia al servidor d'aplicacions Model Gate ni s'emmagatzema a l'emmagatzematge local/de sessió. CORS ha de permetre aquesta sol·licitud del navegador. El model provat rep preguntes i instruccions de llibre tancat, mai la clau de respostes, respostes de referència, etiquetes positives/negatives o errors esperats.
No hi ha cap cerca de tall, cerca allotjada, població bancària o generació de preguntes en aquest cicle de vida. La selecció de la instantània local no és una trucada de generació de pagament. El proveïdor extern pot cobrar per la seva sol·licitud; el jutge de primer pla utilitza la credencial de Model Gate elegible seleccionada. Manteniu la pestanya oberta. L'indicador d'etapa en directe mostra el temps transcorregut i el treball real; mentre una verificació està activa, el navegador avisa abans de tancar, tornar a carregar o navegar. Això no continua la sol·licitud en segon pla. Tornar a provar una avaluació incompleta utilitza la resposta que encara es manté al navegador, no una segona sol·licitud de model provat. Una trucada incerta no es reprodueix automàticament.
El navegador transmet directament la sol·licitud de respostes del jutge en primer pla api.model-gate.com, sense cerca allotjada. El flux de jutges de diversos minuts no es manté obert panel.model-gate.com. Les comprovacions automàtiques de format i l'antiga puntuació següent de la instrucció romanen excloses; La valoració semàntica correspon exclusivament al jutge.
Correspondència només per a jutges
El jutge rep les respostes actuals, les respostes correctes i totes les observacions de referència agrupades per als 32 fets seleccionats, incloses les observacions contradictòries i les seves multiplicitats. Avalua la correcció, el comportament declarat RECALL/INFERÈNCIA/ENDOVENCA/DESCONEGUT i les sortides en qualsevol direcció. Les respostes correctes inesperades a preguntes de referència habitualment no resoltes poden reduir la correspondència; les respostes correctes reals no es reetiqueten malament. Només el jutge assigna la puntuació de la correspondència, la categoria d'avaluació de la identitat, la confiança, els motius i les limitacions. El servidor valida l'estructura de l'informe i compta les observacions desades, però no aplica cap llindar semàntic, penalització, puntuació ponderada o conclusió de substitució.
Una puntuació alta no és una probabilitat d'identitat exacta del model. L'informe no pot establir el preu d'un model ni la data de formació. La instantània i el punt de referència emmagatzemats identifiquen exactament el que es va comparar. Els informes antics de la v1.7 conserven el seu mètode original i no es combinen amb les proves de la v2. No es calcula cap insígnia automàtica d'identitat de la comunitat a partir de les puntuacions de la v2.
Informes i privadesa
El seguiment en directe mostra la sol·licitud, la resposta del navegador, la càrrega útil d'avaluació i la sortida del jutge sense credencials. Una execució privada no conserva la resposta completa del proveïdor en brut ni la resposta visible textualment per pregunta per a la recuperació del navegador; Es mantenen les qualificacions normalitzades, les explicacions i els identificadors de referència immutables. La publicació és una subscripció explícita independent. Els informes de la v2 publicats mostren la conclusió desada del jutge sense executar una altra avaluació o una nova puntuació del servidor. Les respostes de referència administrativa tenen el seu propi cicle de vida retingut/auditat, a diferència de les respostes normals del navegador.
Sol·licitud de compatibilitat i errors del proveïdor (10.28.1)
La sol·licitud de verificació de finalitzacions de xat col·loca les instruccions completes del llibre tancat i totes les preguntes, en ordre, en un sol missatge de l'usuari. Això evita requerir una passarel·la compatible amb OpenAI per traduir un rol del sistema quan s'envia a un backend d'estil antròpic. El protocol seleccionat i el punt final exacte segueixen sent autoritat: no hi ha cap canvi de protocol basat en el nom del model, sol·licitud addicional de model provat o conversió de proxy d'ús general. Native Anthropic Messages encara utilitza el nivell superior system amb un missatge d'usuari; Responses conserva la seva entrada canònica d'usuari. La traça mostra el JSON de sortida real. Es manté la compatibilitat de transport establerta. Behavioral-reference v2 proporciona una sol·licitud fixada de 32 preguntes sense canviar la regla de sol·licitud d'un model provat.
Les respostes que no són 2xx són errors d'HTTP, no sobres correctes no reconeguts. S'informa d'un error del proveïdor arrel com a Sobre d'error del proveïdor, fins i tot quan es retornen amb HTTP 200. Aquests errors mai proporcionen respostes de model, mai arriben a l'avaluació del jutge i no es poden reparar mitjançant l'avaluació de Reintentar la mateixa resposta. La compatibilitat de protocols és NOT_ASSESSED per a una resposta d'error. Qualsevol sol·licitud externa executada encara pot ser facturable; la selecció de referència local no fa cap trucada del generador. Els errors del proveïdor en brut segueixen sent els diagnòstics locals del navegador en lloc del contingut de l'informe públic. Un error genèric de la porta amunt de Model Gate no revela deliberadament el missatge amunt en brut només de l'administrador.
Administració automàtica de referències
Els administradors configuren la col·lecció de referències automàtica una vegada per als models de catàleg existents i futurs aptes. S'utilitzen la connexió de l'API Model Gate configurada i la clau d'administrador, amb límits compartits de trucades d'API diàries/de tota la vida i sense pressupost de reserva automàtica en USD. Els models necessiten un tall oficial o una estimació no oficial d'origen separat per ancorar la col·lecció; el treballador no investiga les dates que falten ni genera preguntes. El valor predeterminat inicial segueix sent deu observacions utilitzables per pregunta i com a màxim vint preguntes diferents per sol·licitud de recollida. Les referències manuals heretades romanen separades.
La referència és una prova del comportament configurat, no una prova de quin proveïdor ha executat una sol·licitud. Les rutes no elegibles o ambigües romanen no disponibles fins que l'administrador resol l'encaminament. Només el jutge valora la correspondència.
Ara tornen els camins de l'API no compatibles 404 endpoint_not_supported amb el camí sol·licitat; retorna un mètode incorrecte en un camí compatible 405 method_not_allowed i Allow. Nadiu /v1/balance no canvia; /v1/user/balance no està implementat. Compartiu l'identificador de sol·licitud retornat, mai la vostra clau d'API, quan informeu d'aquests errors.