API'ye giriş

Numex AI Developer API, uygulamanızı Türkçe yapay zeka özellikleriyle entegre etmenizi sağlar. Chat, Görsel Üretimi, TTS, STT, Embeddings, Belge Analizi ve Web Arama endpoint'leri tek API anahtarı ile kullanılabilir. Tüm endpoint'ler /api/v1 base URL'i altında REST tabanlıdır.

Kimlik doğrulama

API'ye erişim için API anahtarı (ön eki nx_live_) kullanılır. Anahtarınızı API sayfasından oluşturabilirsiniz. Her istekte aşağıdaki başlıklardan birini gönderin:

Anahtarı güvenli tutun; istemci tarafında veya public depolarında paylaşmayın.

v1 Endpoint'ler (Mart 2026)

Aktif endpoint'ler: /api/v1/chat (sohbet), /api/v1/images/generate (görsel), /api/v1/audio/speech (TTS), /api/v1/audio/transcriptions (STT), /api/v1/embeddings, /api/v1/documents/analyze, /api/v1/search, /api/v1/models (GET, auth opsiyonel).

Örnek: Chat

curl -X POST https://www.numexai.com.tr/api/v1/chat \
  -H "Authorization: Bearer nx_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Merhaba", "history": [], "maxOutputTokens": 600}'

Örnek: TTS

curl -X POST https://www.numexai.com.tr/api/v1/audio/speech \
  -H "Authorization: Bearer nx_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "Metninizi buraya yazın.", "voice": "zeynep"}'

Token sistemi

Developer API token bazlı çalışır. Her istek planınıza göre token tüketir. Bakiye yetersizse 402 döner. Token satın almak için plan sayfasını kullanın.

Hata yönetimi

API standart HTTP kodları (200, 400, 401, 402, 429, 500) döner. 429: rate limit; 401: geçersiz anahtar; 402: yetersiz token. Hata yanıtları JSON'da error alanıyla gelir. Detaylar için API Referansı.

Özet