API'ye giriş
Numex AI API, uygulamanızı Türkçe yapay zeka özellikleriyle entegre etmenizi sağlar. Sohbet tamamlama, metin üretimi ve özelleştirilmiş model çağrıları için REST tabanlı endpoint'ler sunar. Bu rehberde kimlik doğrulama, istek formatı ve yaygın kullanım senaryoları özetlenmektedir.
Kimlik doğrulama ve anahtar
API'ye erişim için API anahtarı kullanılır. Anahtarınızı Numex AI hesabınızdan oluşturabilirsiniz. Her istekte Authorization: Bearer <API_ANAHTARINIZ> başlığını göndermeniz gerekir. Anahtarı güvenli tutun; istemci tarafında veya public depolarında paylaşmayın.
Endpoint'ler ve kullanım
Temel sohbet endpoint'i mesajlarınızı JSON formatında alır ve model yanıtını döner. İstek gövdesinde messages dizisi, model seçimi ve isteğe bağlı temperature, max_tokens gibi parametreler kullanılır. Rate limit ve kota bilgisi için API dokümantasyonundaki güncel limitlere bakın.
Hata yönetimi ve limitler
API, standart HTTP durum kodları (200, 400, 401, 429, 500) döner. 429 durumunda istek sıklığınızı azaltın; 401 için anahtarınızı kontrol edin. Hata yanıtları JSON içinde error ve message alanlarıyla açıklanır. Detaylı endpoint listesi ve örnek kodlar için API Dokümantasyonu sayfamızı inceleyin.
Özet
- API anahtarı ile Bearer token kullanarak kimlik doğrulama yapın.
- İstekleri JSON formatında gönderin; messages ve model alanlarını doğru doldurun.
- Rate limit ve kotalara uyun; hata kodlarına göre uygulamanızda geri bildirim verin.
- Güncel endpoint ve parametreler için api-docs sayfasını kullanın.