Geliştirici API Portalı

Numex Developer API

Yapay zeka modellerini, kod üreticilerini ve ses asistanlarını uygulamalarınıza saniyeler içinde dahil edin.

🌐 Giriş

Numex Developer API, Türkçe optimize yapay zeka altyapımıza programatik olarak erişmenizi sağlar. REST mimarisini kullanan API'miz, JSON formatında istek ve yanıtları destekler.

Base URL: https://www.numexai.com.tr/api/v1

🔑 Yetkilendirme

API isteklerinizin kimlik doğrulaması Bearer Token yöntemiyle gerçekleştirilir. API anahtarınızı istek başlığında Authorization parametresiyle iletmeniz gerekir.

Authorization: Bearer nx_live_a1b2c3d4e5f6g7h8i9j0...

Güvenlik Uyarısı: API anahtarınızı asla istemci tarafı (client-side) kodlarında saklamayın. İstekleri kendi güvenli arka plan sunucularınızdan gönderin.

🤖 Modeller

Platformumuzda projenize en uygun hız, maliyet ve kalite dengesini kurabileceğiniz modeller yer almaktadır:

numex-pro

En gelişmiş model. Türkçe'de en yüksek başarım, karmaşık akıl yürütme ve yaratıcı görevler için.

128K context4K outputVisionFunctions

numex-fast

Hız ve maliyet odaklı. Günlük görevler, sınıflandırma ve basit sorgular için optimize.

32K context4K output~3x hızlı

numex-think

Derin akıl yürütme. Matematik, mantık, strateji ve çok adımlı problem çözümü.

128K context8K outputChain-of-thought

numex-code

Kod üretimine özel. Otomatik tamamlama, bug fix, code review ve refactoring.

64K context8K output25+ dil

numex-vision

Görsel anlama ve analiz. Image-to-text ve OCR.

Image→TextOCRTürkçe

numex-audio

Ses tanıma ve transkript. Türkçe konuşmayı metne çevirir (STT).

STTTranskriptTürkçe

💬 Chat completions

Çok turlu sohbet yapısı üzerinden yapay zekaya istek gönderme ve yanıt alma.

POST/api/v1/chat

İstek Parametreleri

Parametre	Tür	Durum	Açıklama
message	string	zorunlu	Gönderilmek istenen mesaj içeriği.
history	array	opsiyonel	Önceki sohbet geçmişi. `role` ("user" / "assistant") ve `content` objelerini içerir.
maxOutputTokens	integer	opsiyonel	Üretilecek maksimum token miktarı (32 - 3000). Varsayılan: 600.

curl https://www.numexai.com.tr/api/v1/chat \
  -H "Authorization: Bearer nx_live_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Python\'da fibonacci fonksiyonu yaz",
    "history": [
      {"role": "user", "content": "Merhaba"},
      {"role": "assistant", "content": "Merhaba! Size nasıl yardımcı olabilirim?"}
    ],
    "maxOutputTokens": 800
  }'

Başarılı Yanıt (200 OK)

{
  "success": true,
  "answer": "def fibonacci(n):\n    if n <= 1:\n        return n\n    return fibonacci(n-1) + fibonacci(n-2)",
  "usage": {
    "estimatedInputTokens": 28,
    "estimatedOutputTokens": 52,
    "estimatedTotalTokens": 80
  }
}

🧠 Embeddings

Girdi metinlerini yapay zeka modelleri tarafından anlaşılabilecek semantik vektör temsillerine dönüştürür. RAG (doküman arama) ve benzerlik eşleştirme uygulamaları için temel oluşturur.

🚧

Geliştirme Aşamasında: Embeddings uç noktası (POST /api/v1/embeddings) test aşamasındadır ve çok yakında genel erişime açılacaktır.

⚠️ Hata Kodları ve Limitler

API isteklerinde karşılaşabileceğiniz standart hata kodları:

400 Bad Request

invalid_parameters

İstek gövdesindeki parametreler hatalı veya eksik.

401 Unauthorized

invalid_api_key

Sağlanan API anahtarı geçersiz, eksik veya süresi dolmuş.

402 Payment Required

insufficient_tokens

API anahtarında istek için yeterli token bakiyesi bulunmuyor.

429 Too Many Requests

rate_limit_exceeded

API anahtarı için tanımlanmış eş zamanlı veya dakikalık çağrı limitleri aşıldı.