> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kiosapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Base URL

> Konfigurasikan host dan path API KiosAPI dengan benar.

# API Base URL

Host KiosAPI adalah:

```text theme={null}
https://kiosapi.com
```

Untuk OpenAI-compatible SDK, gunakan base URL berikut:

```text theme={null}
https://kiosapi.com/v1/
```

## Path berdasarkan format API

| Kebutuhan | URL lengkap |
| - | - |
| OpenAI Chat Completions | `https://kiosapi.com/v1/chat/completions` |
| OpenAI Responses | `https://kiosapi.com/v1/responses` |
| Claude native | `https://kiosapi.com/v1/messages` |
| Gemini native | `https://kiosapi.com/v1beta/models/{model}:generateContent` |

`/v1/` adalah base URL untuk OpenAI SDK. Endpoint native Claude memakai `/v1/messages`, sedangkan endpoint native Gemini memakai `/v1beta` dan path modelnya.

## Contoh konfigurasi

### Python OpenAI SDK

```python theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KIOSAPI_API_KEY"],
    base_url="https://kiosapi.com/v1/",
)
```

### Node.js OpenAI SDK

```javascript theme={null}
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KIOSAPI_API_KEY,
  baseURL: "https://kiosapi.com/v1/",
});
```

### Permintaan HTTP langsung

Untuk HTTP langsung, gabungkan host dengan endpoint yang dituju dan pilih header autentikasi sesuai [panduan autentikasi](https://docs.kiosapi.com/id/authentication.md).

```bash theme={null}
curl "https://kiosapi.com/v1/chat/completions" \
  -H "Authorization: Bearer ${KIOSAPI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"Halo!"}]}'
```

> [!WARNING]
>
> Jangan mengganti `https://kiosapi.com/v1/` dengan host provider lain ketika menggunakan API key KiosAPI. Kesalahan host, `/v1`, `/v1/messages`, atau `/v1beta` dapat menghasilkan `401` atau `404`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.