Cohere API ile Nasıl Çalışılır

Cohere, geliştiricilere insan benzeri metinleri anlayabilen ve üretebilen gelişmiş Büyük Dil Modellerine (LLM'ler) erişim sağlar. Bu modellerle programlı olarak etkileşim kurmak için bir API anahtarına ihtiyacınız vardır. Bu anahtar, isteklerinizi doğrulamak ve kullanımınızı izlemek için Cohere'in sistemlerinin kullandığı benzersiz tanımlayıcınız ve şifreniz olarak görev yapar.

Bu kılavuz, temel adımlarda size yol gösterecektir: API anahtarınızı edinme, anahtar türleri arasındaki kritik farklılıkları (özellikle maliyetler ve kullanım sınırları ile ilgili) anlama ve anahtarınızın doğru çalıştığından emin olmak için Apidog aracını kullanarak basit bir ilk test gerçekleştirme.

Adım 1: Cohere API Anahtarınızı Edinme

Anahtarınızı almak ilk ve en önemli adımdır. Cohere, bu süreci çevrimiçi panoları aracılığıyla nispeten basit hale getirir.

1. Cohere Panosuna Gidin: Web tarayıcınızı açın ve ana Cohere platformu erişim noktasına gidin. Genellikle bir oturum açma veya kaydolma sayfası bulursunuz.
2. Hesabınıza Erişim:

• Zaten bir Cohere hesabınız varsa, kimlik bilgilerinizi kullanarak oturum açın.
• Cohere'e yeniyseniz, bir hesap için kaydolmanız gerekir. Genellikle bir e-posta adresi sağlamayı ve bir şifre belirlemeyi içeren kayıt işlemini izleyin.

API Anahtarları Bölümünü Bulun: Cohere panosunda oturum açtıktan sonra, özellikle API Anahtarlarını yönetmeye ayrılmış bir bölüm arayın. Bu, hesap ayarları, bir geliştirici bölümü altında veya "API Anahtarları" etiketli bir menü öğesi aracılığıyla doğrudan erişilebilir olabilir. Arayüz kullanıcı dostu olacak şekilde tasarlanmıştır, bu nedenle nispeten belirgin olmalıdır.

Anahtar Oluşturmayı Başlatın: API Anahtarları bölümünde, yeni bir anahtar oluşturma seçeneği bulacaksınız. Büyük olasılıkla, özellikle "Deneme Anahtarı" ve potansiyel olarak "Üretim Anahtarı" olmak üzere anahtar türleri arasında ayrım yapan seçenekler göreceksiniz. İlk test ve öğrenme için, bir Deneme Anahtarı oluşturma seçeneğini seçin.

Bir Ad Atayın: Bir istem, anahtarınıza bir ad vermenizi isteyecektir. Özellikle farklı projeler için birden fazla anahtar oluşturursanız, daha sonra amacını hatırlamanıza yardımcı olacak açıklayıcı bir ad seçin. Örnekler arasında "MyFirstTestKey", "LearningProjectKey" veya "ApidogTestingKey" bulunur.

Anahtarınızı Oluşturun ve Güvenceye Alın: Anahtarı onaylamak ve oluşturmak için düğmeye tıklayın (örneğin, "Deneme Anahtarı Oluştur"). Cohere daha sonra yeni oluşturulan API anahtarınızı görüntüleyecektir. Bu, tam anahtarın gösterildiği tek zamandır. Bu anahtarı derhal kopyalamanız ve bir şifre yöneticisi veya güvenli bir not gibi çok güvenli bir konumda saklamanız kesinlikle önemlidir. Ona bir şifreyle aynı güvenlik düzeyinde davranın. Bunu herkese açık olarak paylaşmayın, doğrudan istemci tarafı koduna gömmeyin veya Git gibi sürüm kontrol sistemlerine işlemeyin. Açılır pencereyi kapattığınızda veya uzaklaştığınızda, güvenlik nedenleriyle tam anahtarı tekrar alamayacaksınız (ancak anahtarın adını ve potansiyel olarak ilk/son birkaç karakterini panoda görebilirsiniz). Kaybederseniz, yenisini oluşturmanız gerekir.

API anahtarınız kopyalandıktan ve güvence altına alındıktan sonra, onunla neler yapabileceğinizi ve ilgili kuralları anlamaya hazırsınız.

Adım 2: Anahtar Türlerini, Maliyetleri ve Kullanım Sınırlarını Anlama

Tüm Cohere API anahtarları eşit yaratılmamıştır. Sahip olduğunuz anahtar türü, API'yi ne kadar, ne kadar hızlı kullanabileceğinizi ve maliyetlere yol açıp açmayacağını belirler. Bu farklılıkları anlamak, beklenmedik kesintilerden veya ücretlerden kaçınmak için hayati öneme sahiptir.

A. Deneme API Anahtarları: Değerlendirme için Ücretsiz

İlk kaydolduğunuzda veya faturalandırma ayarlamadan bir anahtar oluşturduğunuzda, genellikle bir Deneme Anahtarı alırsınız. Bunlar keşif, öğrenme ve küçük ölçekli testler için tasarlanmıştır.

• Maliyet: Deneme anahtarlarının kullanımı ücretsizdir. Bir deneme anahtarıyla ilişkili kullanım için faturalandırılmayacaksınız.
• Genel Kullanım Sınırı: En önemli kısıtlama, tüm Cohere uç noktaları genelinde aylık 1.000 toplam API çağrısı sınırıdır. Bu, yaptığınız her isteğin (Chat, Embed, Rerank vb. için olsun) bu aylık toplama dahil olduğu anlamına gelir. Bir takvim ayında 1.000 çağrıya ulaştığınızda, anahtarınız bir sonraki ay başlayana kadar çalışmayı durduracaktır.
• Oran Sınırları (Dakikada İstek - RPM): Adil kullanım ve sistem kararlılığını sağlamak için, Deneme anahtarları ayrıca, belirli uç noktalara bir dakikalık bir pencere içinde kaç istek gönderebileceğinizi kısıtlayan katı oran sınırlarına sahiptir. Bunları bilmek çok önemlidir, çünkü bunları aşmak 429 Too Many Requests hatalarına neden olacaktır. Temel Deneme oranı sınırları şunları içerir:
• Chat Uç Noktası (/v2/chat): Dakikada 20 istek. Bu, konuşma yapay zekası, metin üretimi, özetleme vb. için kullanılan uç noktadır.
• Embed Uç Noktası (/v2/embed) - Metin: Dakikada 100 istek. Metin verileri için vektör gömme oluşturmak için kullanılır (anlamsal arama, kümeleme).
• Embed Uç Noktası (/v2/embed) - Görüntüler: Dakikada 5 istek. Görüntü verileri için vektör gömme oluşturmak için kullanılır (çok modlu arama).
• Rerank Uç Noktası (/v2/rerank): Dakikada 10 istek. Arama sonuçlarının alaka düzeyini iyileştirmek için kullanılır.
• Tokenize Uç Noktası (/v2/tokenize): Dakikada 100 istek. Metnin Cohere'in modelleri tarafından nasıl tokenlara ayrıldığını görmek için kullanılır.
• Classify Uç Noktası (/v1/classify): Dakikada 100 istek. Metin sınıflandırma görevleri için kullanılır (eski, artık ince ayar tercih edilir).
• Eski Uç Noktalar (Özetle, Oluştur): Dakikada 5 istek.
• Diğer/Varsayılan: Diğer daha az yaygın veya yönetim uç noktaları için sınırlar geçerli olabilir.

Deneme anahtarları şunlar için idealdir:

• Cohere API'sinin nasıl çalıştığını öğrenmek.
• Playground'da veya doğrudan çağrılar aracılığıyla farklı modeller ve parametrelerle denemeler yapmak.
• Sınırlı beklenen kullanımla küçük kişisel projeler veya prototipler oluşturmak.
• Ücretli kullanıma geçmeden önce Cohere'in yeteneklerini değerlendirmek.

Aylık sınıra veya dakika başına oran sınırlarına sürekli olarak ulaşırsanız, bu, bir Üretim anahtarına yükseltmeniz gerektiğinin güçlü bir göstergesidir.

B. Üretim API Anahtarları: Oluşturma ve Ölçeklendirme İçin

Gerçek kullanıcılarla uygulamalar oluşturmaya, daha önemli iş yüklerini yönetmeye veya deneme sınırlamalarının ötesine geçmeye hazır olduğunuzda, bir Üretim Anahtarına ihtiyacınız olacaktır. Bu, Cohere hesabınızda faturalandırma bilgilerini ayarlamanızı gerektirir.

• Maliyet: Üretim anahtarları, öncelikle token kullanımına dayalı bir kullandıkça öde modeli üzerinde çalışır. Tokenlar, modellerin işlediği metin birimleridir (kabaca kelimelere veya kelime parçalarına karşılık gelir). Hem modele gönderdiğiniz tokenler (giriş tokenleri) hem de modelin yanıtında oluşturduğu tokenler (çıktı tokenleri) için ücretlendirilirsiniz.
• Fiyatlandırma Modele Göre Değişir: Daha güçlü modeller genellikle token başına daha hafif, daha hızlı modellerden daha pahalıdır.
• Örnek Fiyatlandırma (Örnekleyici - güncel oranlar için Cohere'in resmi fiyatlandırma sayfasını kontrol edin):
• Command R Modeli: Milyon giriş tokeni başına yaklaşık 0,50 ABD Doları ve milyon çıktı tokeni başına 1,50 ABD Doları tutabilir. (Not: Önceki arama sonucu Command R için 2,50 ABD Doları giriş / 10,00 ABD Doları çıktı gösteriyordu - bu değerleri kullanarak: 2,50 ABD Doları / 1M giriş tokeni, 10,00 ABD Doları / 1M çıktı tokeni.)
• Command R+ Modeli: Daha yetenekli olmak, muhtemelen daha yüksek bir fiyata sahip olacaktır, belki de milyon giriş tokeni başına 3,00 ABD Doları ve milyon çıktı tokeni başına 15,00 ABD Doları.
• Embed Modelleri (örneğin, embed-english-v3.0): Gömme modelleri tipik olarak yalnızca giriş tokenleri üzerinden fiyatlandırılır, çünkü uzun metin çıktıları oluşturmazlar. Fiyatlandırma, milyon giriş tokeni başına yaklaşık 0,10 ABD Doları olabilir.
• Token Hesaplama: Cohere, metnin doğru maliyet tahmini için tokenlara nasıl dönüştüğünü anlamanıza yardımcı olmak için bir Tokenizer uç noktası ve dokümantasyon sağlar. Daha uzun girişler ve çıktılar doğal olarak daha pahalıya mal olur.
• Genel Kullanım Sınırı: Üretim anahtarları için aylık toplam çağrı sınırı yoktur. Oran sınırları dahilinde kaldığınız ve maliyetlerinizi yönettiğiniz sürece, gerektiği kadar çağrı yapabilirsiniz.
• Oran Sınırları (Dakikada İstek - RPM): Üretim anahtarları, uygulamaların çok daha fazla trafiği işlemesine izin veren önemli ölçüde daha yüksek oran sınırlarından yararlanır:
• Chat Uç Noktası (/v2/chat): Dakikada 500 istek (Deneme için 20/dakika ile karşılaştırıldığında).
• Embed Uç Noktası (/v2/embed) - Metin: Dakikada 2.000 istek (100/dakika ile karşılaştırıldığında).
• Embed Uç Noktası (/v2/embed) - Görüntüler: Dakikada 400 istek (5/dakika ile karşılaştırıldığında).
• Rerank Uç Noktası (/v2/rerank): Dakikada 1.000 istek (10/dakika ile karşılaştırıldığında).
• Tokenize Uç Noktası (/v2/tokenize): Dakikada 2.000 istek.
• Classify Uç Noktası (/v1/classify): Dakikada 1.000 istek.
• Oran Sınırı Artışları: Çok yüksek hacimli uygulamalar için, Cohere desteğiyle iletişime geçerek daha fazla oran sınırı artışı talep etmek mümkün olabilir.

Üretim anahtarları şunlar için gereklidir:

• Son kullanıcılar için tasarlanan uygulamalar geliştirmek ve dağıtmak.
• Tutarlı veya yüksek hacimli API isteklerini işlemek.
• Herhangi bir ticari kullanım durumu.
• Deneme sınırlarıyla kısıtlanmadan tam performans potansiyelinin kilidini açmak.

C. Doğru Anahtarı Seçme:

• Denemeyle Başlayın: Öğrenme ve ilk geliştirme için her zaman bir Deneme anahtarıyla başlayın.
• Kullanımı İzleyin: Çağrı hacminizi ve sıklığınızı takip edin.
• Gerektiğinde Yükseltin: Uygulamanız sürekli olarak oran sınırlarına ulaşıyorsa, 1.000 aylık çağrı sınırını aşıyorsa veya halka açık veya ticari olarak piyasaya sürmeye hazırlanıyorsanız, Cohere panosunda faturalandırma ayrıntılarını ekleyerek bir Üretim anahtarına yükseltin.

Tamam, işte curl komutunda sağlanan akışlı sohbet isteğini Apidog kullanarak test etmeye odaklanan revize edilmiş 3. Adım bölümü, Markdown olarak sunulmuştur:

Adım 3: Apidog ile Akışlı Sohbet için Temel Bir API Test Çağrısı Yapma

API'yi karmaşık koda entegre etmeden önce, özellikle akış yanıtları için, doğrudan bir test yapmak faydalıdır. Apidog, anahtarınızı doğrulamak ve akış için temel istek/yanıt akışını anlamak için curl komut yapısını çoğaltmanıza olanak tanır.

1. Apidog'u Başlatın: Bilgisayarınızdaki Apidog uygulamasını açın.
2. Yeni Bir İstek Oluşturun: Yeni bir API isteği oluşturmak için '+' düğmesine veya eşdeğerine tıklayın. Ona "Cohere Streaming Chat Test" gibi açıklayıcı bir ad verin.
3. Uç Noktayı Yapılandırın:

• HTTP Yöntemi: POST'u seçin.
• URL: Cohere v2 Chat uç noktası URL'sini girin: https://api.cohere.ai/v2/chat

4. Başlıkları Ayarlayın:

• "Başlıklar" sekmesine gidin. curl komutuna göre birkaç başlık eklemeniz gerekir:
• Kabul Et: Anahtar: Accept, Değer: application/json
• İçerik Türü: Anahtar: Content-Type, Değer: application/json
• Yetkilendirme: Anahtar: Authorization, Değer: Bearer YOUR_API_KEY (YOUR_API_KEY'i gerçek Cohere API anahtarınızla değiştirin. Bearer'dan sonra bir boşluk olduğundan emin olun).

5. İstek Gövdesini Oluşturun (Akış Etkinleştirilmiş):

• "Gövde" sekmesine gidin.
• "ham" giriş seçeneğini seçin.
• Format olarak JSON'u seçin.
• curl komutunun verilerini yansıtan, kritik "stream": true bayrağı dahil olmak üzere aşağıdaki JSON yükünü yapıştırın:

{
  "stream": true,
  "model": "command-r",
  "messages": [
    {
      "role": "user",
      "content": "Hello world!"
    }
  ]
}

(Not: curl örneği "role": "user" (küçük harf) ve model "command-a-03-2025" kullandı. Önceki örneklerle tutarlılık için "role": "USER" ve model "command-r"'yi korudum, ancak yukarıdaki JSON'daki model ve rol durumunu, test etmeyi amaçladığınız belirli istekle tam olarak eşleşecek şekilde ayarlamalısınız.)

6. İsteği Yürütün: Apidog'daki "Gönder" düğmesine tıklayın.

7. Yanıtı Analiz Edin (Akışa Özgü Özellikler):

• Durum Kodu: İlk istek sunucu tarafından kabul edilirse hala bir 200 OK durum kodu almalısınız.
• Yanıt Başlıkları: Transfer-Encoding: chunked gibi akış belirtileri için yanıt başlıklarını kontrol edin.
• Yanıt Gövdesi: Apidog'un akış yanıtını nasıl görüntülediği değişebilir. Şunları yapabilir:
• Akış tamamlanana kadar bekleyin ve tamamen birleştirilmiş metni veya son olay yükünü gösterin.
• Ham parçaları veya Sunucu Tarafından Gönderilen Olayları (SSE) geldikleri gibi gösterin, potansiyel olarak art arda birden fazla JSON nesnesi gibi görünür.
• Metni, amaca yönelik bir uygulama gibi token token düzgün bir şekilde oluşturması olası değildir.
• İçerik: Yanıt gövdesi içeriğine bakın. "Hello world!" yanıtının parçalarını içeren text-generation olayları ve sonunda işlemin bittiğini gösteren bir stream-end olayı gibi akışla ilgili olaylar görmelisiniz.
• Hatalar: Hata alırsanız (401, 403, 400, 429), bunları daha önce açıklandığı gibi teşhis edin (API anahtarını, JSON geçerliliğini, oran sınırlarını kontrol edin). Belirtilen model akışı desteklemiyorsa veya diğer parametreler uyumsuzsa bir 400 Bad Request oluşabilir.

Bu test, API'nin akış isteğinizi kabul ettiğini ve anahtarınızın bu tür bir etkileşim için geçerli olduğunu doğrulamaya yardımcı olur, Apidog'un kendisi akışın gerçek zamanlı doğasını görselleştirmek için ideal bir araç olmasa bile. Temel istek kurulumunun doğru olduğunu doğrular.

Sonuç

Artık Cohere API anahtarınıza sahipsiniz ve Deneme ve Üretim anahtarları arasındaki kritik farklılıkları, özellikle Deneme anahtarlarındaki 1.000 aylık çağrı sınırı ve dakika başına oran sınırları ile Üretim anahtarlarının kullandıkça öde, token tabanlı fiyatlandırması ve daha yüksek sınırları ile ilgili olarak anlıyorsunuz. Ayrıca, anahtarınızın çalıştığını ve basit bir API çağrısı yapılandırabileceğinizi doğrulamak için Apidog kullanarak temel ancak hayati bir test gerçekleştirdiniz.

Bu temel, Cohere API'si ile etkili bir şekilde etkileşim kurmak için gereklidir. Anahtarınızı güvende tutmayı, kullanımınızı sınırlamalara karşı izlemeyi (özellikle bir Deneme anahtarında) ve daha gelişmiş uygulamalar oluşturmaya başladığınızda belirli modeller, gelişmiş parametreler ve SDK kullanımı hakkında ayrıntılı bilgi için Cohere'in belgelerine başvurmayı unutmayın.