Dokumentasi AI Gateway API

Overview

Endpoint ini mem-proxy request ke model yang sudah dipublish di Admin > Member AI Chat. Jika admin mengganti provider atau model aktif, daftar model API otomatis mengikuti konfigurasi tersebut.

Base URL https://kiosdev.com/api/v1/ai

Compatible OpenAI Chat, OpenAI Responses, Claude Messages

Authentication

Gunakan API key member. Header Bearer direkomendasikan untuk kompatibilitas OpenAI dan CLI, tetapi X-API-Key tetap didukung.

Authorization: Bearer rpk_live_xxxxxxxxxxxxxxxxx
Accept: application/json
Content-Type: application/json

Models

Mengembalikan model aktif yang diizinkan admin untuk dipakai member dan API gateway.

GET https://kiosdev.com/api/v1/ai/models

curl "https://kiosdev.com/api/v1/ai/models" \
  -H "Authorization: Bearer rpk_live_xxxxxxxxx"

Chat Completions

Format kompatibel OpenAI /v1/chat/completions. Untuk gambar, kirim content array dengan image_url data URL.

POST https://kiosdev.com/api/v1/ai/chat/completions

curl "https://kiosdev.com/api/v1/ai/chat/completions" \
  -H "Authorization: Bearer rpk_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "Tulis satu kalimat sapaan." }
    ]
  }'

Responses API

Format kompatibel OpenAI Responses API untuk client yang memakai /v1/responses.

POST https://kiosdev.com/api/v1/ai/responses

curl "https://kiosdev.com/api/v1/ai/responses" \
  -H "Authorization: Bearer rpk_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "Jawab singkat: apa itu API gateway?"
  }'

Claude Messages

Format kompatibel Claude Messages API untuk client yang mengirim request ke endpoint messages.

POST https://kiosdev.com/api/v1/ai/messages

curl "https://kiosdev.com/api/v1/ai/messages" \
  -H "Authorization: Bearer rpk_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [
      { "role": "user", "content": "Halo" }
    ]
  }'

Streaming

Tambahkan "stream": true. Response dikirim sebagai Server-Sent Events dan diakhiri dengan data: [DONE] untuk endpoint OpenAI-compatible.

curl -N "https://kiosdev.com/api/v1/ai/chat/completions" \
  -H "Authorization: Bearer rpk_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "stream": true,
    "messages": [
      { "role": "user", "content": "Balas dengan 3 kata." }
    ]
  }'

API Tester

Tes chat non-stream langsung dari browser memakai API key member.

Response

CLI Config

Untuk client yang kompatibel OpenAI, arahkan base URL ke gateway website ini. Nama file dan field bisa berbeda tergantung CLI yang dipakai.

model_provider = "kiosdev"
model = "gpt-5.5"

[model_providers.kiosdev]
name = "KIOSDEV"
base_url = "https://kiosdev.com/api/v1/ai"
wire_api = "responses"
requires_openai_auth = true

{
  "OPENAI_API_KEY": "rpk_live_xxxxxxxxx"
}

AI Gateway API untuk integrasi chat dan automation.