API'ye giriş

Numex AI Developer API, uygulamanızı Türkçe yapay zeka ile entegre etmenizi sağlar. /api/v1 altında sohbet, görsel üretimi, TTS, STT, embeddings, belge analizi, web arama, model listesi, streaming ve function calling uç noktaları API referansında yer alır; tek API anahtarı kullanılır. Video ve müzik üretimi bu API kapsamında yoktur. Plan, token ve admin özellik ayarları geçerlidir.

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)

/api/v1/chat, /api/v1/images/generate, /api/v1/images/status/:id, /api/v1/audio/speech, /api/v1/audio/transcriptions, /api/v1/embeddings, /api/v1/documents/analyze, /api/v1/search, /api/v1/models (GET, auth opsiyonel). Streaming ve function calling: api-docs gelişmiş bölümleri.

Ö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