# API anahtarları

> API için anahtar oluşturma, kapsamlandırma ve yönetme.

Source: https://reverie.im/tr/docs/integrations/api-keys
Language: tr

Bir API anahtarı, Reverie'nin [Açık API](https://reverie.im/tr/docs/integrations/open-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 \[#create-a-key]

### Yeni API Anahtarı Oluştur'a basın \[#press-create-new-api-key]

Sayfa boşken düğmede **İlk API Anahtarınızı Oluşturun** yazar.

### Ona bir ad verin \[#name-it]

**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 \[#choose-global-or-a-specific-character]

**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 \[#optionally-set-a-device-type-and-an-expiry]

**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 \[#keys-stay-retrievable]

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 \[#global-keys-and-pinned-keys]

|                             | **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 \[#disable-delete-rotate]

| 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 \[#scopes]

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 →](https://reverie.im/tr/docs/characters/import-characters)

## Kullanım istatistikleri \[#usage-statistics]

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 \[#build-a-request]

**İ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 \[#limits]

| 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 \[#related]

* [Açık API](https://reverie.im/tr/docs/integrations/open-api) — uç noktalar, istek biçimi ve hatalar
* [Karakter içe aktarma](https://reverie.im/tr/docs/characters/import-characters) — içe aktarma anahtarı ne işe yarar
* [Reverie Labs](https://reverie.im/tr/docs/integrations/labs) — Açık API ve içe aktarma karoları
* [Güvenlik](https://reverie.im/tr/docs/account/security) — hesabınızın diğer erişim ayarları