Todennus
Kaksi tunnistetietoa — API-avain koneille, istunto konsolille — ja säännöt, jotka pitävät ne erillään.
Kaksi tunnistetietotyyppiä
API ottaa vastaan API-avaimen. Konsoli ottaa vastaan istuntoevästeen. Ne eivät ole keskenään vaihdettavissa, ja API valvoo tätä sen sijaan, että päättäisi pyyntökohtaisesti, oliko evästeen tarkoitus olla mukana.
Istuntoevästeellä todennettu pyyntö saa 403 api_key_required, ja viestissä viitataan konsolin avainsivulle. Tämä on tarkoituksellista: kun APIin ei ole evästeellä todennettua reittiä, ei ole mitään, mitä ristisivustopyyntö voisi väärentää.
Otsake
Lähetä avain bearer-tokenina. Avain on etuliite, piste ja salaisuus; etuliite yksilöi rivin, joten mitätöinti on välitöntä ja vaatii yhden haun.
curl https://api.llmeu.com/v1/chat/completions \
-H "Authorization: Bearer llmeu_live_xxxxxxxx.your-secret" \
-H "Content-Type: application/json" \
-d '{"model":"llmeu-auto","messages":[{"role":"user","content":"Hello"}]}'Käyttöalueet
Avain sisältää yhden tai useamman käyttöalueen. Pyyntö, jonka avaimelta puuttuu päätepisteen vaatima käyttöalue, hylätään koodilla 403 insufficient_scope ennen kuin runko jäsennetään.
| Käyttöalue | Mahdollistaa |
|---|---|
| inference | Chat completions-, embeddings- sekä malliluettelo- ja mallitietopäätepisteet. |
| platform_read | Lue organisaatiosi tiedot: profiili, avaimet, käyttö, jäljitykset ja käytännöt. |
| platform_write | Luo ja mitätöi avaimia sekä luo tai muokkaa käytäntöjä. Tämä on käyttöalue, joka muuttaa sitä, kuka saa tehdä mitä, joten myönnä se harkiten. |
Käyttöalueet tarkistetaan päätepistekohtaisesti, ei avainkohtaisesti. Avain, jolla on platform_read, ei voi kuluttaa saldoa playgroundin kautta.
Avaimen luominen
Konsolissa tai alustan API:n kautta avaimella, jolla on jo platform_write. Salaisuus näytetään kerran, kun se luodaan: vain scrypt-tiiviste tallennetaan, joten kukaan — mukaan lukien me — ei voi lukea sitä takaisin.
curl -X POST https://api.llmeu.com/platform/v1/api-keys \
-H "Authorization: Bearer llmeu_live_xxxxxxxx.a-platform-write-key" \
-H "Content-Type: application/json" \
-d '{"name":"ci","scopes":["inference"]}'Konsolin ylläpitotoimet — käytännöt, tiimi, asetukset, saldo, avainten mitätöinti — ovat vain omistajan tai ylläpitäjän tehtävissä riippumatta avaimen käyttöalueista.
Mitätöinti ja se, mitä avain ei ole
Avain kuuluu organisaatiolle, ja organisaatio päätellään avaimesta itsestään — ei koskaan pyynnön rungon kentästä, joten kutsuja ei voi kohdistaa pyyntöä toiselle vuokralaiselle pyytämällä nätisti. Mitätöinti tulee voimaan seuraavassa pyynnössä. Vaihtaminen tarkoittaa toisen avaimen luomista, liikenteen siirtämistä ja sitten ensimmäisen mitätöintiä; määritettävää päällekkäisyysikkunaa ei ole.
Konsolille sen sijaan
Sisäänkirjautuminen, salasanan palautus ja osoitteen vahvistus dokumentoidaan konsolin yhteydessä. OAuthia, SAML:ää tai henkilökohtaista käyttöoikeustunnusta ei ole: konsoli käyttää istuntoevästettä, API käyttää avaimia.