Liya AI API'sine Hoş Geldiniz
Güçlü AI asistanlarını uygulamalarınıza dakikalar içinde entegre edin. RESTful API'miz ve hazır npm paketlerimiz ile hızlıca başlayın.
Güvenli
API anahtarı tabanlı kimlik doğrulama
Hızlı
100ms altı yanıt süresi
Ölçeklenebilir
Yüksek hacimli istekler için optimize
Kimlik Doğrulama
Tüm API isteklerinde X-API-Key header'ı kullanın. API anahtarınızı proje ayarlarından alabilirsiniz.
X-API-Key: your_api_key_here
Güvenlik & Rate Limiting
Liya AI API kurumsal düzeyde güvenlikle tasarlanmıştır. Tüm iletişimler şifrelenir ve API anahtarları güvenli bir şekilde yönetilir.
HTTPS/TLS
Tüm API iletişimleri TLS 1.2+ ile şifrelenir. Düz HTTP istekleri otomatik olarak reddedilir.
API Key
API anahtarları proje kapsamlıdır ve kontrol panelinden her zaman iptal edilebilir. Anahtarları istemci tarafı kodda asla açığa çıkarmayın.
Rate Limiting
Varsayılan rate limit API anahtarı başına 60 istek/dakikadır. Rate limit başlıkları (X-RateLimit-Limit, X-RateLimit-Remaining) her yanıtta yer alır.
CORS
CORS proje bazında yapılandırılır. Cross-origin istekleri etkinleştirmek için proje ayarlarından izin verilen origin'leri ekleyin.
En İyi Güvenlik Uygulamaları
- •API anahtarlarını ortam değişkenlerinde saklayın, kaynak kodunuza asla doğrudan yazmayın.
- •Mümkün olduğunca sunucu tarafı API çağrıları kullanın. İstemci tarafı widget'lar için kimlik doğrulamayı güvenli şekilde yöneten npm paketlerini kullanın.
- •API anahtarlarınızı düzenli olarak yenileyin ve kullanılmayan anahtarları hemen iptal edin.
- •Olağandışı aktiviteyi tespit etmek için kontrol panelinden API kullanımınızı izleyin.
Desteklenen AI Modelleri
Liya AI platformu, OpenAI'ın en güncel modellerini destekler. Her model farklı kullanım senaryoları için optimize edilmiştir.
Flagship Modeller
En güçlü ve kapsamlı modeller. Karmaşık görevler, uzun bağlam ve yüksek kaliteli çıktılar için idealdir.
| Model | Context | Input | Output | Özellikler |
|---|---|---|---|---|
| liyaAiLuna HOT | 128K tokens | — | — | Fast, Optimized, Coding |
| gpt-5.4 | 1M / 128K output | $10.00/1M | $60.00/1M | Code, Vision, 128K Output |
| gpt-5.4-pro | 1M / 128K output | $60.00/1M | $360.00/1M | Ultra Tier |
| gpt-5.4-mini NEW | 400K tokens | $11.25/1M | $67.50/1M | Code, subagent |
| gpt-5.4-nano NEW | — | $8.00/1M | $50.00/1M | Basit görevler |
| gpt-5 | 1M tokens | $5.00/1M | $40.00/1M | Code, Vision |
Reasoning Modeller
Gelişmiş düşünme yetenekleri ile karmaşık problemleri adım adım çözen modeller. Matematik, kodlama ve analitik görevlerde üstün performans.
| Model | Context | Input | Output | En İyi Kullanım |
|---|---|---|---|---|
| o4-mini | 200K tokens | $16.50/1M | $66.00/1M | Hızlı reasoning, kod debug, günlük analitik görevler |
| o3 | 200K tokens | $8.00/1M | $32.00/1M | Karmaşık matematik, bilimsel analiz, stratejik planlama |
| o3-mini | 200K tokens | $16.50/1M | $66.00/1M | Hızlı reasoning |
Mistral AI Models
| Model | Context | Input | Output | Best For |
|---|---|---|---|---|
| mistral-large-latest | 32K tokens | $32.00/1M | $96.00/1M | Complex Reasoning |
| mistral-medium-3-5 | 32K tokens | $16.00/1M | $48.00/1M | Enterprise |
| mistral-small-2603 | 32K tokens | $3.20/1M | $9.60/1M | High Speed |
Maliyet-Etkin Modeller
Yüksek hacimli uygulamalar için optimize edilmiş, uygun maliyetli modeller.
| Model | Context | Input | Output | En İyi Kullanım |
|---|---|---|---|---|
| gpt-5-mini | 1M tokens | $3.75/1M | $30.00/1M | Genel görevler, kod yazma |
| gpt-4.1-mini | 1M tokens | $6.00/1M | $24.00/1M | Genel amaçlı, chatbot, müşteri desteği |
| gpt-4.1-nano | 1M tokens | $4.00/1M | $16.00/1M | Ultra düşük maliyet, basit görevler, yüksek hacim |
Claude Modelleri
AnthropicAnthropic'in Claude modelleri. Uzun bağlam, güvenlik odaklı ve yüksek kaliteli çıktılar için optimize edilmiştir.
| Model | Context | Özellikler | En İyi Kullanım |
|---|---|---|---|
| claude-opus-4-7 NEW | 1M tokens | Flagship | Karmaşık mimari, derin analiz, uzun dökümanlar |
| claude-opus-4-6 | 1M tokens | Flagship | Karmaşık mimari, derin analiz, uzun dökümanlar |
| claude-sonnet-4-6 | 1M tokens | Balanced | Kod yazma, genel görevler, dengeli performans |
| claude-haiku-4-5 | 200K tokens | Fast & Cheap | Hızlı yanıt, basit görevler, yüksek hacim |
Google Gemini
GoogleGoogle'ın en yeni çok modlu AI modelleri. Genişletilmiş düşünme yetenekleri ve 1M token bağlam desteği.
| Model | Context | Input | Output | En İyi Kullanım |
|---|---|---|---|---|
| gemini-3.1-pro | 1M tokens | — | — | Flagship, Thinking |
| gemini-3-flash | 1M tokens | — | — | Fast, Balanced |
| gemini-3.1-flash-lite | 1M tokens | — | — | Ultra-cheap |
| gemini-2.5-pro | 1M tokens | — | — | Legacy |
| gemini-2.5-flash | 1M tokens | — | — | Legacy Flash |
| gemini-2.5-flash-lite | 1M tokens | — | — | Ultra-cheap |
DeepSeek
DeepSeek V4DeepSeek'in V3.2 modelleri. Coding için optimize edilmiş, uygun fiyatlı ve 128K context desteği.
| Model | Context | Input | Output | En İyi Kullanım |
|---|---|---|---|---|
| deepseek-v4-flash | 128K tokens | $2.24/1M | $4.48/1M | Coding, hızlı yanıtlar |
| deepseek-v4-pro | 128K tokens | $17.40/1M | $34.80/1M | Coding, debug, genel görevler |
| deepseek-reasoner | 128K tokens | $6.89/1M | $55.06/1M | Derin muhakeme, matematik, karmaşık analiz |
xAI Grok
xAIxAI tarafından geliştirilen Grok modelleri. Geniş context, hızlı yanıt ve rekabetçi fiyatlandırma.
| Model | Context | Input | Output | En İyi Kullanım |
|---|---|---|---|---|
| grok-4.3 Default | 1M tokens | $10.00/1M | $20.00/1M | Balanced, General Purpose |
| grok-4.20-0309-non-reasoning Fast | 1M tokens | $10.00/1M | $20.00/1M | Low Latency, Quick Tasks |
| grok-4.20-0309-reasoning Reasoning | 1M tokens | $10.00/1M | $20.00/1M | Deep Reasoning, Complex Problems |
| grok-4.20-multi-agent-0309 Multi-Agent | 2M tokens | $10.00/1M | $20.00/1M | Parallel Processing, Workflows |
Moonshot Kimi Models
Gelişmiş Çince desteği ve geniş bağlam penceresi.
| Model | Context | Input | Output |
|---|---|---|---|
| kimi-k2.6 | 128K | $4.00/1M | $20.00/1M |
| kimi-k2.5 | 128K | $8.61/1M | $45.17/1M |
| kimi-v1 | 128K | $10.00/1M | $40.00/1M |
Xiaomi MiMo Models
LiyaAI Ceres Xiaomi MiMo serisi — 小米 (küçük tahıl). Flash, Omni, Pro ve Thinking modelleri. Ceres akıllı yönlendirme ile otomatik model seçimi. Fiyat formülü: api_maliyet × model_markup × user_type_markup.
| Model | Context | Input | Output |
|---|---|---|---|
| mimo-v2-flash ⚡ Fast | 32K | $1.60/1M | $4.80/1M |
| mimo-v2-omni Vision | 32K | $6.40/1M | $32.00/1M |
| mimo-v2.5 | 32K | $6.40/1M | $32.00/1M |
| mimo-v2-pro NEW | 32K | $10.00/1M | $30.00/1M |
| mimo-v2.5-pro NEW | 32K | $10.00/1M | $30.00/1M |
| mimo-v2-flash-thinking CoT | 32K | $2.40/1M | $7.20/1M |
api_maliyet × model_markup × user_type_markup formülüyle hesaplanmıştır. Alibaba Qwen
Alibaba CloudAlibaba Cloud altyapısı üzerinde çalışan Qwen modelleri. Çin pazarı, geniş context ve çoklu dil desteği.
| Model | Context | Input | Output | En İyi Kullanım |
|---|---|---|---|---|
| qwen3.5-flash | 128K tokens | $4.00/1M | $16.00/1M | Fast & Cheap |
| qwen3.5-plus | 128K tokens | $6.00/1M | $36.00/1M | Balanced |
| qwen3-max | 128K tokens | $4.80/1M | $24.00/1M | Flagship |
| qwen3.6-max NEW | 128K tokens | $5.00/1M | $25.00/1M | Flagship |
GLM
Zhipu AIZhipu AI tarafından geliştirilen GLM serisi modeller. Çin pazarı ve çoklu dil desteği için optimize edilmiştir.
| Model | Context | Input | Output | En İyi Kullanım |
|---|---|---|---|---|
| glm-5-turbo | 128K tokens | $5.17/1M | $24.08/1M | Fast & Cheap |
| glm-4.7 | 128K tokens | $5.17/1M | $24.08/1M | Balanced |
| glm-5 | 128K tokens | $4.58/1M | $20.64/1M | Advanced |
| glm-5.1 | 128K tokens | $12.00/1M | $48.00/1M | Reasoning |
LiyaAI Furby
Akıllı Model Yönlendirme
LiyaAI Furby, isteğinizi otomatik analiz eder ve en uygun modeli seçer. Basit görevler uygun fiyatlı modelleri, karmaşık görevler güçlü modelleri kullanır.
Kısa sorular, çeviri, formatlama
→ Haiku 3.5Kod yazma, analiz, genel görevler
→ Sonnet 4Mimari, debugging, derin akıl yürütme
→ Opus 4Ortalama Tasarruf
Her zaman Opus kullanmaya kıyasla
LiyaAI Iris
GPT Akıllı Yönlendirme
LiyaAI Iris isteğinizi otomatik analiz eder ve en uygun GPT modelini seçer. Basit görevler Nano, karmaşık görevler GPT-4.1 veya o3 kullanır.
Kısa sorular, çeviri, formatlama
→ GPT-4.1-nanoKod yazma, analiz, genel görevler
→ GPT-5-miniMimari, akıl yürütme, derin düşünme
→ GPT-5 / GPT-5.4Mimari, algoritma
→ o4-miniOrtalama Tasarruf
Her zaman GPT-4.1 kullanmaya kıyasla
LiyaAI Castor
Gemini Akıllı Yönlendirme
LiyaAI Castor isteğinizi otomatik analiz eder ve en uygun Gemini modelini seçer. Basit görevler Flash-Lite, karmaşık görevler düşünme özellikli Pro kullanır.
Kısa sorular, çeviri, formatlama
→ Flash-LiteKod yazma, analiz, genel görevler
→ FlashMimari, düşünme, derin akıl yürütme
→ ProOrtalama Tasarruf
Her zaman Pro kullanmaya kıyasla
LiyaAI Nereus
DeepSeek Akıllı Yönlendirme
Görev karmaşıklığına göre en uygun DeepSeek modelini otomatik seçer. Basit görevlerde Chat, karmaşık muhakemede Reasoner kullanılır.
Hızlı kod düzeltmeleri, formatlama
→ V4 FlashMimari, refactoring, kod üretimi
→ V4 ProAlgoritma, matematiksel analiz
→ ReasonerAdım adım planlama
→ V4 Pro + ThinkingClaude'a Kıyasla Tasarruf
Aynı coding görevleri için ~%80 daha ucuz
LiyaAI Yu
Qwen Akıllı Yönlendirme
Görev karmaşıklığına göre en uygun Qwen modelini otomatik seçer. Alibaba Cloud altyapısı ile yüksek performans.
Hızlı sorgular, hafif görevler
→ Qwen TurboDengeli performans ve kalite
→ Qwen Plus / 3.5 PlusEn yüksek kalite, zorlu görevler
→ Qwen Max / 3.5 MaxBağlam Penceresi
Uzun dokümanlar için ideal
LiyaAI Nuwa
GLM Akıllı Yönlendirme
Görev karmaşıklığına göre en uygun GLM modelini otomatik seçer. Zhipu AI teknolojisi ile güçlü analiz.
Günlük kullanım için dengeli
→ GLM 4.7 / 5-TurboEn yüksek kalite, karmaşık görevler
→ GLM 5 / 5.1Bağlam Penceresi
Uzun dokümanlar için ideal
LiyaAI Luna
Kimi Akıllı Yönlendirme
Görev karmaşıklığına göre en uygun Kimi modelini otomatik seçer. Verimlilik ve performans dengesi sağlar.
Kimi modelleri ile optimize edilmiş doğruluk ve hız.
Göreve en uygun modeli anında belirler.
Büyük Bağlam
Uzun metinler ve projeler için ideal.
Teknik Notlar
temperature & top_p
Yanıtların yaratıcılığını kontrol eder. Düşük değerler daha tutarlı, yüksek değerler daha yaratıcı yanıtlar üretir.
temperature: 0.0 - 2.0 (default: 0.7) top_p: 0.0 - 1.0 (default: 1.0)
reasoning_effort
Reasoning modelleri için düşünme derinliğini belirler. Yüksek değerler daha doğru ama daha yavaş ve pahalı sonuçlar verir.
reasoning_effort: "none" | "low" | "medium" | "high" // Only for: o3, o3-mini, o1
GAR - Global Application Router
GAR, Liya AI platformunun akıllı yönlendirme katmanıdır. Backend sunucularından periyodik olarak toplanan sistem metrikleri (CPU, RAM, yanıt süresi) doğrultusunda kullanıcıları otomatik olarak en uygun sunucuya yönlendirir. HMAC-SHA256 imzalı internal API ve gerçek zamanlı sağlık izleme ile endüstri standardında sağlam bir altyapı sunar.
Mimari
Frontend
Kullanıcı arayüzü. Login/Register işlemlerinde GAR'a sorgu yapar.
GAR
Akıllı yönlendirici. Sistem metriklerini analiz ederek en uygun backend'i otomatik seçer.
Backends
Birden fazla backend sunucusu. Her biri periyodik olarak sağlık metriklerini GAR'a raporlar.
Login Akışı
- 1localStorage'da backend URL kontrol edilir
- 2Yoksa GAR'a POST /user-backend/ ile sorgu yapılır
- 3GAR kullanıcının backend URL'ini döndürür
- ✓URL localStorage'a kaydedilir ve login işlemi yapılır
Register Akışı
- 1GAR'dan GET /available-backend/ ile müsait backend alınır
- 2Kullanıcı seçilen backend'e kayıt olur
- 3POST /register-user/ ile GAR'a eşleştirme kaydedilir
- 4Backend URL localStorage'a kaydedilir
Teknik Detaylar
Yük Dengeleme
Backend seçimi gerçek zamanlı sistem metriklerine (CPU, RAM, yanıt süresi, aktif bağlantı) göre yapılır. Bu metrik tabanlı yaklaşım, tahmine değil gerçek veriye dayalı sağlam bir yük dengeleme sağlar.
Önbellekleme
Kullanıcı-backend eşleştirmeleri Redis'te önbelleklenir. Tekrarlayan sorgular için veritabanı yükü azaltılır.
Kalıcı Eşleştirme
Kullanıcı bir kez backend'e atandığında, tüm oturumları boyunca aynı backend'i kullanır. HMAC-SHA256 imzalı güvenli iletişim ile veri tutarlılığı ve bütünlüğü garanti altındadır.
NPM Paketleri
Hazır npm paketlerimiz ile AI chat özelliklerini web sitenize veya uygulamanıza kolayca ekleyin.
Vue.js
@liyalabs/liya-ai-chat-vue
Vue 3 Composition API ile uyumlu bileşenler.
3D Avatar Widget
@liyalabs/liya-3d-avatar-widget-vuejs
Vue.js 3 için 3D konuşan avatar widget. Lip-sync, sesli yanıt, inline görsel/video gösterimi ve çoklu mod desteği.
Vanilla JS / PHP Widget
@liyalabs/liya-3d-avatar-widget-vanilla-js
Saf HTML, PHP ve framework kullanmayan ortamlar için 3D konuşan avatar widget. Build adımı gerektirmez.
3D Avatar Widget (React)
@liyalabs/liya-3d-avatar-widget-react
React için 3D konuşan avatar widget. Lip-sync, sesli yanıt, inline görsel/video gösterimi ve çoklu mod desteği.
Sanal Sınıf
@liyalabs/liya-ai-env-vuejs
Vue.js 3 için 3D sanal sınıf ortamı. Tam vücut avatar, el hareketleri ve etkileşimli ortam.
Flutter Widget
liya_3d_avatar_widget_flutter
iOS ve Android için native 3D avatar widget. pub.dev'de yayınlandı.
VS Code Extension
liyalabs.liyaai-coding-agent
VS Code için AI destekli kod asistanı. GPT-4, Claude modelleri ile akıllı kod yardımı.
IntelliJ Extension
ai.liyalabs.coding-agent
IntelliJ tabanlı IDE'ler için AI destekli kod asistanı. GPT-4, Claude modelleri ile akıllı kod yardımı.
LiyaChatWidget
Web sitenize ekleyebileceğiniz floating chat widget. Sağ alt köşede görünür ve tıklandığında açılır.
Hızlı Başla
API anahtarınızı alın ve projelerinizi AI gücüyle dakikalar içinde canlandırın.
Kod Örnekleri
import axios from 'axios';
const api = axios.create({
baseURL: 'https://app-X-ai.liyalabs.com', // Your assigned backend URL
headers: {
'X-API-Key': 'your_api_key_here'
}
});
// List assistants
async function getAssistants() {
const response = await api.get('/api/v1/external/assistants/');
return response.data;
}
// Send message
async function sendMessage(assistantId, message, customerId) {
const response = await api.post('/api/v1/external/chat/', {
assistant_id: assistantId,
message: message,
external_id: customerId
});
return response.data;
}Hemen Entegre Edin
API anahtarınızı alın ve dakikalar içinde AI asistanınızı uygulamanıza entegre edin.
Ücretsiz BaşlaLiyaAI Coding Agent — Plugin Docs
VS Code ve IntelliJ plugin'i için rehberler ve best practices
LiyaAI OS Asistanı
v0.2.0WebSocket üzerinden LiyaAI backend'e bağlanan, workspace izolasyonu ve komut beyaz listesi ile sistem komutlarını çalıştıran hafif daemon.
Çalışma Modları
Salt Okunur
Güvenilmeyen ortamlar için güvenli. Dosya işlemleri, sistem bilgisi, servisler, loglar, süreçler ve Docker konteynerleri dahil 16 salt okunur araç.
Workspace Kapsamlı
İzole workspace'ler içinde beyaz listeli komut çalıştırma. Geri alma destekli git pull, dosya yazma, Python/shell scripting ve cron job yönetimi.
Sudo
Güvenilir ortamlar için tam komut erişimi. Bağımlılık farkındalığı ile systemd servis kontrolü ve kısıtlamasız komut çalıştırma.
Kurulum
wget -qO - https://packages.liyalabs.com/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/liyalabs.gpgecho "deb [signed-by=/etc/apt/keyrings/liyalabs.gpg] https://packages.liyalabs.com/debian stable main" | sudo tee /etc/apt/sources.list.d/liyalabs.listsudo apt-get update
sudo apt-get install liyaai-os-assistantpackages.liyalabs.com, LiyaLabs'ın resmi paket sunucusudur. Paketler kurulum öncesinde imzalanır ve doğrulanır.
Yapılandırma
Yapılandırma dosyasını düzenleyin
sudo nano /etc/liyaai/config.yamlAPI kimlik bilgilerinizi ayarlayın
api:
api_key: "your-api-key-here"
assistant_id: "your-assistant-uuid-here"
backend_ws_url: "wss://backend.liyalabs.com/v1/ws/os"
daemon:
mode: "readonly" # "readonly" | "workspace_scoped" | "sudo"
workspace:
allowed_workspaces:
- "/srv/triton-demo"
sudo_allowed_commands:
- "git pull"
- "nginx -s reload"Servis Yönetimi
sudo systemctl start liyaai-daemonsudo systemctl stop liyaai-daemonsudo systemctl restart liyaai-daemonsudo systemctl enable liyaai-daemonsudo systemctl status liyaai-daemonsudo journalctl -u liyaai-daemon -fsudo tail -f /var/log/liyaai/info.log
sudo tail -f /var/log/liyaai/error.logGüvenlik Özellikleri
Tam Eşleşmeli Komut Beyaz Listesi
Komutlar için tam string eşleşmesi — regex yok, varyasyonlara izin verilmez.
Sıkı Yol Doğrulama
Yol kaçırma atlatmalarını önlemek için trailing separator kontrolleriyle realpath doğrulama.
Komut Enjeksiyonu Önleme
Parametreler shell meta-karakter enjeksiyonunu önlemek için subprocess.run'a liste olarak aktarılır (shell=False).
Sabit Reddedilen Yollar
Kullanıcı yapılandırmasına bakılmaksızın kritik sistem yolları (örn. /etc/liyaai) engellenir.
Workspace İzolasyonu
Scriptler ve komutlar sadece izin verilen workspace dizinlerinde çalışır.
Symlink Saldırı Koruması
Realpath kontrolleri symlink'ler üzerinden workspace'ten kaçışı engeller.
İstek Limitleri
İstek başına 1MB yazma, 10MB okuma, 500 satır çıktı limiti.
Denetim Kaydı
Tüm araç çalıştırmaları istek ID'leri ve parametrelerle kaydedilir.