KIVON API

Güçlü AI tamamlama API'si. Modern, hızlı ve kolay entegrasyon.

https://kivon-3.onrender.com

Auth

Bearer Token

Çevre değişkenleri ile yönetilir

Rate Limit

60 req / dk

Format

JSON
GET / Durum kontrolü

Açıklama

Sunucu durumu, model listesi ve genel bilgileri döndürür.

Örnek Yanıt

{
"status": "online",
"models": [
"openrouter/deepseek-v4-flash",
"openrouter/qwen3-next",
"openrouter/llama-3.3-70b"
"groq/llama-3.3-70b"
],
"uptime": 3600
}

curl

# Status kontrolü
curl https://kivon-3.onrender.com
POST /api/groq AI Chat tamamlama

Açıklama

Belirtilen modele AI sohbet tamamlama isteği gönderir. Tüm modeller OpenRouter ve Groq üzerinden sunulur.

Parameters

Parametre Tip Açıklama
soru required string AI'ye gönderilecek mesaj
sistem optional string Sistem promptu (varsayılan: "Sen yardımsever bir asistansın.")
model optional string Model ID (varsayılan: openrouter/deepseek-v4-flash)

Kullanılabilir Modeller

openrouter/deepseek-v4-flash openrouter/qwen3-next openrouter/llama-3.3-70b groq/llama-3.3-70b

İstek Örneği

const response = await fetch("https://kivon-3.onrender.com/api/groq", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer KIVON_API_KEY"
},
body: JSON.stringify({
"soru": "Merhaba, bugün nasılsın?",
"sistem": "Sen yardımsever bir asistansın.",
"model": "openrouter/deepseek-v4-flash"
})
});

const data = await response.json();
console.log(data);

Örnek Yanıt

{
"success": true,
"response": "Merhaba! Ben harikayım, teşekkür ederim. Size nasıl yardımcı olabilirim?",
"model": "openrouter/deepseek-v4-flash"
}
ERR Hata Kodları API hata referansı

Hata Kodları

Kod Açıklama
400 Geçersiz istek — zorunlu parametreler eksik
401 Yetkisiz — geçersiz veya eksik API anahtarı
429 Çok fazla istek — rate limit aşıldı
500 Sunucu hatası — geçici bir sorun oluştu

Örnek Hata Yanıtı

{
"success": false,
"error": "soru parametresi zorunludur"
}
RATE Rate Limitler
İstek Limiti 60 requests / dakika
Limit Başlığı X-RateLimit-Limit
Kalan X-RateLimit-Remaining
Sıfırlanma X-RateLimit-Reset
AUTH Kimlik Doğrulama

Tüm API istekleri Authorization: Bearer başlığı gerektirir. API anahtarı sunucu ortam değişkenleri (KIVON_API_KEY) ile yönetilir.

# İstek başlığı
Authorization: Bearer <api_anahtarınız>