TL;DR
TypingMind, kendi API anahtarlarınızı kullanarak GPT, Claude, DeepSeek ve diğer desteklenen modellere bağlanmanıza olanak tanıyan esnek bir yapay zeka sohbet arayüzüdür. CometAPI’yi OpenAI ile uyumlu bir bağlantı üzerinden entegre ederek ayrı ayrı sağlayıcı hesapları yapılandırmadan birden fazla yapay zeka modeline erişebilirsiniz. Bu kılavuz, CometAPI API anahtarınızı ve Chat Completions endpoint’ini kullanarak özel bir model eklemeyi, ilk iletinizi göndermeyi ve yaygın kurulum hatalarını gidermeyi açıklar. Bir CometAPI API anahtarına, kullanılabilir hesap bakiyesine ve TypingMind’in özel model ayarlarına erişime ihtiyacınız olacaktır. Temel bir metin istemiyle başlayın, ardından gerektiğinde gelişmiş yetenekleri etkinleştirin. API bağlantısını test etmek için isteğe bağlı Bash ve cURL örneği de dahildir.
Ana Noktalar
- Tek bir API anahtarı, birden çok model: desteklenen sağlayıcılara tek bir CometAPI hesabıyla erişin.
- OpenAI ile uyumlu entegrasyon: özel bir SDK olmadan standart Chat Completions endpoint’ini yapılandırın.
- Esnek model seçimi: TypingMind’de CometAPI tarafından desteklenen birden fazla modeli kaydedin.
- Ayrı faturalandırma: model çıkarımı CometAPI tarafından faturalandırılır; TypingMind lisanslaması ayrıdır.
TypingMind nedir
TypingMind, sizin sağladığınız API anahtarlarıyla modellere bağlanan bir yapay zeka sohbet arayüzüdür. Modelleri seçmek ve konuşmaları yönetmek için tek bir yer sunar. Arayüzü TypingMind sağlar; bağlı API hizmeti model isteklerini ve kullanım faturalandırmasını yürütür.
CometAPI, GPT, Claude, Gemini ve DeepSeek dahil olmak üzere birden çok sağlayıcının desteklenen modelleri için TypingMind’e paylaşılan bir API bağlantısı sağlar. API erişimini ve faturalandırmayı tek bir CometAPI hesabı üzerinden yönetebilir, ardından kullanmak istediğiniz modeller için TypingMind’de ayrı özel model girişleri oluşturabilirsiniz. Böylece yazma, kodlama veya günlük sorular için farklı modelleri, her sağlayıcıyla ayrı bir API hesabı açmadan denemek kolaylaşır.
CometAPI’yi TypingMind’e bağlamadan önce nelere ihtiyacınız var?
anahtar oluşturma talimatlarını izleyerek CometAPI hesabınızın API Keys bölümünden bir anahtar oluşturun. Bu bağlantı için adanmış bir anahtar kullanın; böylece ilişkili olmayan entegrasyonları etkilemeden iptal edebilirsiniz. Anahtarı ekran görüntülerinde, paylaşılan belgelerde ve herkese açık depolarda paylaşmayın.
CometAPI; GPT, Claude, Gemini ve DeepSeek dahil birden fazla model ailesini destekler; yalnızca GPT-6 Luna ile sınırlı değildir. Bu eğitim, yapılandırma tablosu ve terminal testi için yalnızca örnek olarak GPT-6 Luna (model kimliği: gpt-6-luna) kullanır. Hesabınızın erişebildiği ve rotası OpenAI Chat Completions’ı destekleyen CometAPI model kataloğundaki başka bir modeli seçebilirsiniz.
Başka bir model kullanırken, hem TypingMind’de hem de cURL isteğinde gpt-6-luna’yı seçtiğiniz modelin tam kimliğiyle değiştirin. Ayrıca görünen adı, bağlam uzunluğunu, fiyatlandırmayı ve yetenek ayarlarını seçilen modele uygun şekilde güncelleyin. Örnek modelin ayarlarının her model için geçerli olduğunu varsaymayın.
Aşağıdaki yapılandırmayı kullanın. TypingMind, tam endpoint URL’sine ihtiyaç duyar; /v1 ile biten bir SDK temel URL’si farklı bir alandır ve burada kullanılmamalıdır.
| TypingMind alanı | Değer |
|---|---|
| Ad | GPT-6 Luna via CometAPI |
| Model Kimliği | gpt-6-luna |
| API türü | OpenAI Chat Completions API |
| Uç nokta URL’si | https://api.cometapi.com/v1/chat/completions |
| Kimlik doğrulama | API Key via HTTP Header |
| Üstbilgi anahtarı | Authorization |
| Üstbilgi değeri | Bearer YOUR_COMETAPI_API_KEY |
CometAPI’yi TypingMind’e nasıl eklersiniz?
Özel bir model oluşturun
TypingMind’i açın, Models’ı seçin ve Add custom model’i seçin. Create Manually seçili kalsın. Bu denetimler manuel yapılandırma iş akışında belgelenmiştir.
Model ayrıntılarını girin
Adı ve model kimliğini yapılandırma tablosundan kopyalayın. Context Length gerekli ise, seçilen modelin belgelenen sınırını kullanın; GPT-6 Luna’nın belgelenen bağlam penceresi 1,050,000 token’dır. Bağlam sınırı, o kadar çok token göndermeniz için bir öneri değil, bir kapasite ayarıdır.
Uç noktayı ve kimlik doğrulamayı ayarlayın
Authentication bölümünde, tablodaki API türünü, endpoint’i, üstbilgi anahtarını ve üstbilgi değerini girin. YOUR_COMETAPI_API_KEY yerine gerçek anahtarınızı yazın. Bearer’dan sonra bir boşluk bırakın ve tırnak işareti kullanmayın.
Her iki ekran görüntüsü de resmi TypingMind kılavuzundan alınmıştır. Boş kimlik doğrulama formu alan yerleşimini gösterir; kendi CometAPI endpoint’inizi, model kimliğinizi ve anahtarınızı girin.
Bağlantıyı test edin ve kaydedin
Metin sohbetiyle başlayın ve isteğe bağlı istek geçersiz kılmalarını boş bırakın. Test & Save’e tıklayın, kaydedilen modeli seçin ve şunu gönderin: “REST API’leri ile WebSocket’leri üç cümlede karşılaştırın.” Görünür bir asistan yanıtı temel bağlantıyı doğrular. Konuşmanın devam ettiğini kontrol etmek için bir takip mesajı gönderin.
İsteğe bağlı yetenekleri etkinleştirin
Metin sohbetiyle başlayın. Yalnızca desteklendiğinde akış (streaming), sistem istemleri, görsel girdi, araçlar veya akıl yürütme (reasoning) denetimlerini etkinleştirin. Gelişmiş yetenekleri ayrı ayrı test edin.
TypingMind’in Yetenekler ayarları otomatik kontroller ve manuel denetimler sunar. Algılamayı bir başlangıç noktası olarak görün: her özelliği seçilen model ve rotayla doğrulayın. Çalışan temel yapılandırmayı saklayın; böylece bir özellik testi başarısız olursa son geçersiz kılmayı kaldırabilirsiniz.
TypingMind dışında CometAPI isteğini nasıl kontrol edersiniz?
Test & Save başarısız olduğunda bu isteğe bağlı testi kullanın. Aynı anahtar ve model kimliğiyle, CometAPI’nin belgelenen Chat Completions istek formatını izleyerek minimal bir istek gönderir. TypingMind yapılandırmasını değiştirmenizi gerektirmez.
Geçerli Bash oturumu için anahtarı ayarlayın
Aşağıdakileri Bash’te (Windows’ta Git Bash veya WSL dahil) çalıştırın. Anahtarı gizli isteme yapıştırın. Bu komutlar Bash sözdizimidir; PowerShell’e olduğu gibi yapıştırılmamalıdır.
read -r -s -p "CometAPI API key: " COMETAPI_API_KEYprintf '\n'export COMETAPI_API_KEY
Minimal bir sohbet isteği gönderin
curl --include --silent --show-error \ https://api.cometapi.com/v1/chat/completions \ -H "Authorization: Bearer $COMETAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6-luna", "messages": [ {"role": "user", "content": "Explain API gateways in one sentence."} ] }'
Asistanın metni için choices[0].message.content alanını inceleyin. cURL bir HTTP hatası döndürürse, ayarları değiştirmeden önce yanıt gövdesini okuyun. Terminal isteği başarılı olurken TypingMind başarısız olursa endpoint, anahtar, model kimliği ve isteğe bağlı geçersiz kılmaları karşılaştırın, ardından tarayıcının Ağ (Network) panelini kontrol edin. Terminalde başarılı bir istek yolun doğru olduğunu doğrular; tarayıcı erişimini veya her model yeteneğini doğrulamaz.
Geçici ortam değişkenini kaldırın
unset COMETAPI_API_KEY
TypingMind bağlantı hataları nasıl giderilir?
Hatalı isteği belirlemek için yanıt gövdesini ve tarayıcının Ağ panelini kullanın. Aşağıdaki kontroller tek başına durum koduna dayalı bir teşhis değil, başlangıç noktalarıdır. Kimlik bilgilerini ekran görüntülerinde ve destek mesajlarında paylaşmayın.
| Belirti | İlk kontrol | Sonraki işlem |
|---|---|---|
| 401 Unauthorized | Anahtar ve Authorization üstbilgisi | Süresi dolmuş/iptal edilmiş anahtar, fazladan boşluklar veya eksik Bearer öneki olup olmadığını kontrol edin. |
| 403 Forbidden | Yanıt gövdesi ve model erişimi | Hesap izinlerini ve seçilen rotaya erişimi doğrulayın. |
| 404 Not Found | Endpoint ve tam model kimliği | Tam /v1/chat/completions URL’sini kullanın ve katalogdaki kimliği doğrulayın. |
| 400 Bad Request | İstek gövdesi ve geçersiz kılmalar | İsteğe bağlı parametreleri kaldırın ve düz bir metin isteğiyle yeniden deneyin. |
| 429 Too Many Requests | Kota veya hız sınırı ayrıntıları | Hesap limitlerini ve krediyi kontrol edin. Hız sınırlı tekrarları duraklatın; tükenen kotayı çözmeden yeniden denemeyin. |
| Tarayıcı ağ hatası | Ağ paneli ve konsol | Bağlantıyı ve bildirilen olası etki alanları arası hatayı kontrol edin; terminal testiyle karşılaştırın. |
| Akış (streaming) başarısız | Akış ayarı ve rota desteği | Sorunu izole etmek için akışı devre dışı bırakarak yeniden deneyin. |
Bir API, Python veya cURL’de çalışırken, etki alanları arası kısıtlamalar nedeniyle tarayıcıda başarısız olabilir. Sadece CORS’u aşmak için kısıtlanmamış bir API anahtarını güvensiz bir genel proxy üzerinden açığa çıkarmayın.
SSS
CometAPI’yi eklerken mevcut bir TypingMind bağlantısını koruyabilir miyim?
Evet: mevcut sağlayıcı girişini düzenlemek yerine, ayırt edici bir görünen adla ayrı bir özel model girişi oluşturun. CometAPI bağlantısını doğrularken orijinal endpoint ve model ayarlarını erişilebilir tutun. Eski bir konuşmanın uzunluğu veya ekleri temel kurulum hatasını gölgelememesi için önce yeni bir sohbette test edin.
TypingMind’de kullanılan bir CometAPI anahtarını nasıl döndürmeliyim?
Yedek bir anahtar oluşturun, eski anahtarı kullanan her özel model girişini güncelleyin ve her girişten yeni bir isteği test edin. Yenisi çalıştıktan sonra eski anahtarı iptal edin. Eski anahtar açığa çıktıysa, derhal iptal edin ve etkilenen bağlantıları yeni bir anahtarla geri yükleyin.
Neden TypingMind’in maliyet tahmini CometAPI faturasıyla farklı olabilir?
TypingMind, kullanım tahminini Fiyatlandırma ayarlarına girilen oranlara göre yapar. Eski oranlar veya önbellek, bağlam katmanı (context-tier) ya da akıl yürütme token’ı hesaplamasındaki farklılıklar uyumsuzluk yaratabilir. Modelin mevcut oranlarını ve belirli bir isteğin kullanımını CometAPI faturalandırma bilgileriyle karşılaştırın; istemci tarafı tahmini nihai ücret olarak değerlendirmeyin.
Sonuç
CometAPI’yi TypingMind’e bağlamak için manuel bir özel model oluşturun, tam Chat Completions endpoint’ini girin, Authorization üstbilgisini ekleyin ve düz bir metin mesajıyla test edin. İsteğe bağlı özellikleri eklemeden önce çalışan bir yapılandırmayı koruyun. Kurulum başarısız olduğunda, minimal bir cURL isteği, hesap veya API hatalarını tarayıcı ve ön uç ayarlarından ayırmaya yardımcı olur.