Mga API key
Gumawa, i-scope at pamahalaan ang mga key para sa API.
Ina-authenticate ng API key ang mga request sa Open API ng Reverie. Nasa Mga Setting → Higit pa → Mga API Key ang mga key, kung saan din tumuturo ang tile na Open API sa Labs. Kahit anong account ay puwedeng gumawa nito — walang kinakailangang tier at walang limitasyon sa dami ng hawak mo.
Gumawa ng key
Pindutin ang Gumawa ng Bagong API Key
Sa walang lamang pahina, Gawin ang Una Mong API Key ang nakasulat sa button.
Pangalanan ito
Kailangan ang Pangalan, 1–100 character. Ito ang label ng key sa listahan at sa mga istatistika ng paggamit — "Speaker sa Sala", "staging worker".
Pumili ng Global o isang partikular na karakter
Ang Pagpili ng Karakter ay pagpili sa pagitan ng Global (Lahat ng Karakter) at Partikular na Karakter, hindi isang opsyonal na dagdag. Ang partikular na karakter ang nagiging naka-pin na karakter ng key.
Opsyonal na magtakda ng uri ng device at pag-expire
Malayang text ang Uri ng Device (speaker, phone, iot). Tumatanggap ang Pag-expire ng petsa at oras; awtomatikong titigil sa paggana ang key sa sandaling iyon.
Agad na lumalabas ang key bilang rk_ na sinusundan ng 64 na hexadecimal na character.
Nakukuha pa rin ang mga key
Hindi minsanang pagpapakita lang ang secret. May Ipakita ang API key, Itago ang API key at Kopyahin ang API key ang card ng bawat key, anumang oras, hangga't umiiral ang key.
Dahil nababasa pa rin ang buong secret mula sa iyong mga setting, ituring ang access sa account bilang access sa key. Itago ang key sa isang server o sa isang secret manager, hindi kailanman sa source control o sa code ng browser.
Mga global key at naka-pin na key
| Global (Lahat ng Karakter) | Partikular na Karakter | |
|---|---|---|
Ibinabalik ng GET /models | Ang mga kamakailan mong karakter | Ang mga scenario ng karakter na iyon, o ang karakter mismo kung wala itong scenario |
Walang model | Babalik sa pinakahuli mong chat | Gagamitin ang naka-pin na karakter |
| Maiikling scenario ID | Hindi kailanman nare-resolve | Nire-resolve batay sa naka-pin na karakter |
I-disable, i-delete, i-rotate
| Aksyon | Epekto | Maibabalik |
|---|---|---|
| Toggle na Aktibo | Tinatanggihan ang mga request na gumagamit ng key habang naka-off ito | Oo |
| I-delete | Sinisira ang key at mawawalan ng access ang mga application na gumagamit nito | Hindi |
Walang hiwalay na aksyon para mag-revoke — ang pag-disable at pag-delete ang dalawang opsyon.
Hindi na maibabalik ang pag-delete ng key, at kasama nitong nawawala ang attribution ng key na iyon: lilipat ang dati nitong traffic sa bucket na Mga na-delete na key sa mga istatistika ng paggamit, kung saan hindi mo na malalaman kung aling integration ang gumastos ng ano. I-disable muna ang key kung baka gusto mo pa ang history.
Para mag-rotate, gumawa ng kapalit, i-deploy ito, saka i-disable o i-delete ang lumang key. Walang awtomatikong rotation at walang palugit pagkatapos ng pag-expire — tatanggihan ang expired na key gamit ang api_key_expired sa susunod na request.
Mga scope
May mga scope ang mga key, at hindi ito ipinapakita ng dialog sa paggawa. Ang key na ginawa mo sa Mga Setting ay makakatawag sa mga chat endpoint, at doon lang.
Ibang scope ang kailangan ng endpoint ng character importer, at ang tanging paraan para makakuha ng ganoong key ay buksan ang Labs → Skill sa Pag-import ng Karakter, na gagawa ng isa para sa iyo na pinangalanang Reverie Character Importer (Skill). Magbabalik ng 403 ang pagtawag sa importer gamit ang ordinaryong key mula sa mga setting. Mag-import ng mga karakter →
Mga istatistika ng paggamit
Iniuulat ng panel na Mga istatistika ng paggamit sa parehong pahina ang Mga request, Mga token, Credits at Mga aktibong key, na nakagrupo ayon sa araw sa UTC, na may breakdown bawat key sa ilalim ng Paggamit ayon sa key. Mag-filter ayon sa isang key o sa Lahat ng key, sa loob ng 7 hanggang 90 araw — 30 bilang default. Ang mga chat lang na ginawa sa pamamagitan ng API ang binibilang.
Sa panel na ito lang makikita ang gastos bawat key. Nakatala sa iyong credit history kung magkano ang bawat mensahe, pero hindi nito nilalagyan ng label ang transaksyon ng key na gumawa nito, kaya gamitin ang mga istatistika rito para paghambingin ang mga integration.
Bumuo ng request
Nagbubukas ang Bumuo ng request ng generator: pumili ng isa sa mga aktibo mong key, pumili ng karakter o scenario mula sa listahang nakikita ng key na iyon, mag-type ng mensahe, piliin ang streaming at temperature, saka kopyahin ang gumaganang cURL, TypeScript o Python.
Ginagamit lang ang key sa browser mo para i-load ang listahan ng mga karakter. Binabasa ng nabuong code ang REVERIE_API_KEY mula sa environment sa halip na i-embed ang secret.
Mga limitasyon
| Limitasyon | Halaga |
|---|---|
| Mga key bawat account | Walang limitasyon |
| Rate limit bawat key | Wala |
| Limitasyon ng sabay-sabay na request bawat key | Wala |
| Ang talagang naglilimita sa paggamit | Ang credit balance mo, pati ang window ng libreng model |
Kaugnay
- Open API — mga endpoint, hugis ng request at mga error
- Mag-import ng mga karakter — para saan ang key ng importer
- Reverie Labs — ang mga tile ng Open API at importer
- Seguridad — ang iba pang setting ng access ng iyong account