AI API untuk Developer

AI API untuk Developer

Kinexa AI API memungkinkan developer mengintegrasikan kemampuan AI ke dalam aplikasi mereka menggunakan Kinexa AI Gateway.

Autentikasi

Semua request AI API memerlukan Bearer token (JWT) yang didapat dari Kinexa SSO:

Authorization: Bearer YOUR_JWT_TOKEN

Token JWT didapat dengan melakukan autentikasi melalui sistem Kinexa SSO. Lihat panduan Memulai dengan Kinexa API untuk detail.

POST /api/ai/chat

Kirim pesan ke AI dan terima respons.

Request:

{
  "messages": [
    { "role": "system", "content": "Kamu adalah asisten yang membantu." },
    { "role": "user", "content": "Apa jam operasional bisnis Anda?" }
  ],
  "model": "auto",
  "temperature": 0.7,
  "max_tokens": 1024
}

• model — Gunakan "auto" agar gateway memilih berdasarkan tier Anda, atau tentukan: "claude-haiku", "claude-sonnet", "claude-opus", "gpt-4o", "qwen2.5", "llama3.2"
• temperature — Level kreativitas (0.0 = deterministik, 1.0 = kreatif)
• max_tokens — Panjang respons maksimum

Response:

{
  "success": true,
  "data": {
    "id": "msg_abc123",
    "content": "Jam operasional kami adalah Senin sampai Jumat, 09.00 - 17.00 WIB.",
    "model": "qwen2.5:7b",
    "provider": "ollama",
    "usage": {
      "prompt_tokens": 24,
      "completion_tokens": 18,
      "total_tokens": 42
    }
  }
}

GET /api/ai/models

Daftar semua model AI yang tersedia untuk tier Anda.

Response:

{
  "success": true,
  "data": [
    { "id": "qwen2.5:7b", "provider": "ollama", "available": true },
    { "id": "claude-haiku", "provider": "anthropic", "available": false, "reason": "Memerlukan tier Pro" }
  ]
}

GET /api/ai/health

Cek status kesehatan semua provider AI.

Response:

{
  "success": true,
  "data": {
    "ollama": { "status": "healthy", "latency_ms": 120 },
    "anthropic": { "status": "healthy", "latency_ms": 340 },
    "openai": { "status": "degraded", "latency_ms": 5200 }
  }
}

Contoh: JavaScript/TypeScript

const response = await fetch("https://api.kinexa.id/v1/ai/chat", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${token}`,
  },
  body: JSON.stringify({
    messages: [
      { role: "user", content: "Rangkum penjualan kami bulan ini" }
    ],
    model: "auto",
  }),
});

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

Rate Limiting per Tier

Saat melebihi limit, Anda menerima respons 429 Too Many Requests dengan header Retry-After.

Kode Error

| 503 | Provider AI sementara tidak tersedia |