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.

Kimlik Doğrulama

Tüm API isteklerinde X-API-Key header'ı kullanın. API anahtarınızı proje ayarlarından alabilirsiniz.

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.

API Endpoints

{
  "status": "success",
  "data": {
    "assistants": [
      {
        "id": "asst_abc123",
        "name": "Customer Support",
        "model": "gpt-4o",
        "created_at": "2025-01-15T10:30:00Z"
      }
    ]
  }
}

{
  "assistant_id": "asst_abc123",
  "message": "Hello!",
  "external_id": "user_123",
  "session_id": "session_uuid"  // optional
}

{
  "status": "success",
  "data": {
    "message": "Hello! How can I help you today?",
    "session_id": "session_uuid",
    "usage": {
      "prompt_tokens": 150,
      "completion_tokens": 25
    }
  }
}

Oturumlar

Oturumlar, kullanıcılarınızın sohbet geçmişini yönetmenizi sağlar.

// 1. Create a new session
const createSession = await fetch('/api/v1/external/sessions/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    assistant_id: 'asst_xxx',
    session_name: 'Customer Support Chat',
    external_session_id: 'user_123'
  })
});
const session = await createSession.json();
// session.data.id = "session_uuid"

// 2. Send messages using session_id
const chat = await fetch('/api/v1/external/chat/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    assistant_id: 'asst_xxx',
    session_id: session.data.id,
    message: 'Hello!'
  })
});

// 3. Get message history
const history = await fetch(
  `/api/v1/external/sessions/${session.data.id}/history/`,
  { headers: { 'X-API-Key': 'your_api_key' } }
);
const messages = await history.json();
// messages.data.messages = [{ role: 'user', content: '...' }, ...]

// 4. List all sessions for an assistant
const sessions = await fetch(
  '/api/v1/external/sessions/?assistant_id=asst_xxx',
  { headers: { 'X-API-Key': 'your_api_key' } }
);
const sessionList = await sessions.json();
// sessionList.data.sessions = [{ id, session_name, message_count, ... }]

Hata Kodları & Yanıt Formatı

Tüm API yanıtları tutarlı bir JSON formatını takip eder. Başarılı yanıtlar 'success' olarak ayarlanmış bir 'status' alanı içerirken, hatalar bir hata kodu ve okunabilir mesaj içerir.

{
  "status": "success",
  "data": { ... }
}

{
  "status": "error",
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The API key provided is invalid."
  }
}

Liya AI platformu, OpenAI'ın en güncel modellerini destekler. Her model farklı kullanım senaryoları için optimize edilmiştir.

temperature: 0.0 - 2.0 (default: 0.7)
top_p: 0.0 - 1.0 (default: 1.0)

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.

NPM Paketleri

Hazır npm paketlerimiz ile AI chat özelliklerini web sitenize veya uygulamanıza kolayca ekleyin.

<script setup>
import { LiyaChatWidget, LiyaChatApp } from '@liyalabs/liya-ai-chat-vue';
</script>

<template>
  <!-- Widget - Floating chat bubble -->
  <LiyaChatWidget 
    position="bottom-right"
    welcome-message="Merhaba! Size nasıl yardımcı olabilirim?"
    @message-sent="handleSent"
    @message-received="handleReceived"
  />

  <!-- App - Full page chat application -->
  <div style="height: 100vh">
    <LiyaChatApp 
      :show-sidebar="true"
      sidebar-width="300px"
      @session-created="onSessionCreated"
    />
  </div>
</template>

Kod Örnekleri Kopyala

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;
}