API anahtarları
API için anahtar oluşturma, kapsamlandırma ve yönetme.
Bir API anahtarı, Reverie'nin Açık API'sine giden istekleri doğrular. Anahtarlar Ayarlar → Daha fazla → API Anahtarları altında durur; Labs'taki Açık API karosu da buraya götürür. Her hesap oluşturabilir — kademe şartı yok, kaç tane tuttuğunuza dair bir tavan da yok.
Anahtar oluşturma
Yeni API Anahtarı Oluştur'a basın
Sayfa boşken düğmede İlk API Anahtarınızı Oluşturun yazar.
Ona bir ad verin
Ad zorunludur, 1–100 karakter. Anahtarın listede ve kullanım istatistiklerinde nasıl etiketleneceğini belirler — "Oturma Odası Hoparlörü", "staging worker".
Genel mi, belirli bir karakter mi
Karakter Seçimi, Genel (Tüm Karakterler) ile Belirli Karakter arasında bir seçimdir; isteğe bağlı bir ek değil. Seçtiğiniz karakter, anahtarın sabitlenmiş karakteri olur.
İsterseniz cihaz türü ve son kullanma ekleyin
Cihaz Türü serbest metindir (speaker, phone, iot). Son Kullanma hem tarih hem saat ister; tam o anda anahtar kendiliğinden çalışmayı bırakır.
Anahtar hemen görünür: rk_ ve ardından 64 onaltılık karakter.
Anahtarlar her zaman görülebilir
Sır yalnızca bir kez gösterilmez. Anahtar var olduğu sürece kartında her an API anahtarını göster, API anahtarını gizle ve API anahtarını kopyala bulunur.
Sırrın tamamı ayarlarınızdan okunabildiğine göre, hesaba erişimi anahtara erişim sayın. Anahtarı bir sunucuda ya da bir sır yöneticisinde tutun; asla sürüm denetiminde veya tarayıcı kodunda bırakmayın.
Genel anahtarlar ve sabitlenmiş anahtarlar
| Genel (Tüm Karakterler) | Belirli Karakter | |
|---|---|---|
GET /models şunu döndürür | Son karakterlerinizi | O karakterin senaryolarını, hiç yoksa karakterin kendisini |
model yazılmadığında | En son sohbetinize düşer | Sabitlenmiş karakteri kullanır |
| Kısa senaryo ID'leri | Asla çözülmez | Sabitlenmiş karaktere göre çözülür |
Devre dışı bırakma, silme, yenileme
| Eylem | Etkisi | Geri alınabilir |
|---|---|---|
| Aktif anahtarı | Kapalıyken o anahtarla gelen istekler reddedilir | Evet |
| Sil | Anahtar yok edilir ve onu kullanan uygulamalar erişimi kaybeder | Hayır |
Ayrı bir iptal eylemi yoktur — devre dışı bırakmak ve silmek, iki seçenek bunlar.
Bir anahtarı silmek geri alınamaz ve o anahtarın kaydını da beraberinde götürür: geçmiş trafiği kullanım istatistiklerindeki Silinmiş anahtarlar kümesine taşınır ve orada hangi entegrasyonun ne harcadığını artık ayırt edemezsiniz. Geçmişe ihtiyacınız olabilecekse önce anahtarı devre dışı bırakın.
Yenilemek için yenisini oluşturun, yayına alın, sonra eskisini devre dışı bırakın ya da silin. Otomatik yenileme yoktur, süre dolduktan sonra da ek süre tanınmaz — süresi geçmiş bir anahtar, sonraki istekte api_key_expired ile reddedilir.
Kapsamlar
Anahtarlar kapsam taşır, ancak oluşturma penceresi bunları göstermez. Ayarlar'da yaptığınız bir anahtar sohbet uç noktalarını çağırabilir, yalnızca onları.
Karakter içe aktarma uç noktası başka bir kapsam ister ve böyle bir anahtarı almanın tek yolu Labs → Karakter İçe Aktarma Yeteneği'ni açmaktır; orada sizin için Reverie Character Importer (Skill) adlı bir anahtar oluşturulur. İçe aktarıcıyı ayarlardan alınmış sıradan bir anahtarla çağırmak 403 döndürür. Karakter içe aktarma →
Kullanım istatistikleri
Aynı sayfadaki Kullanım istatistikleri paneli İstekler, Token, Kredi ve Aktif anahtarlar değerlerini UTC gününe göre kümelenmiş biçimde bildirir; Anahtara göre kullanım başlığı altında anahtar anahtar dökümünü verir. Tek bir anahtara ya da Tüm anahtarlar'a göre süzün; pencere 7 ile 90 gün arasındadır — varsayılanı 30. Yalnızca API üzerinden açılmış sohbetler sayılır.
Anahtar başına harcamanın var olduğu tek yer bu paneldir. Kredi geçmişiniz her mesajın ne tuttuğunu kaydeder ama işlemi hangi anahtarın yaptığını yazmaz; entegrasyonları karşılaştırmak için buradaki istatistikleri kullanın.
İstek oluştur
İstek oluştur bir üreteci açar: aktif anahtarlarınızdan birini seçin, o anahtarın görebildiği listeden bir karakter ya da senaryo seçin, bir mesaj yazın, akış ve sıcaklık ayarını belirleyin, sonra çalışır durumdaki cURL, TypeScript ya da Python kodunu kopyalayın.
Anahtar tarayıcınızda yalnızca karakter listesini yüklemek için kullanılır. Üretilen kod sırrı içine gömmek yerine REVERIE_API_KEY değerini ortamdan okur.
Sınırlar
| Sınır | Değer |
|---|---|
| Hesap başına anahtar | Sınır yok |
| Anahtar başına hız sınırı | Yok |
| Anahtar başına eşzamanlılık tavanı | Yok |
| Kullanımı asıl sınırlayan | Kredi bakiyeniz ve ücretsiz model penceresi |
İlgili
- Açık API — uç noktalar, istek biçimi ve hatalar
- Karakter içe aktarma — içe aktarma anahtarı ne işe yarar
- Reverie Labs — Açık API ve içe aktarma karoları
- Güvenlik — hesabınızın diğer erişim ayarları