> ## 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.

# curl

> Panggil KiosAPI langsung dengan curl melalui endpoint yang kompatibel dengan OpenAI, Anthropic, dan Gemini.

# curl

Gunakan `curl` untuk menguji KiosAPI langsung dari terminal. Contoh di bawah memakai kunci API yang dibuat di [Dashboard KiosAPI](https://kiosapi.com) melalui **Token Management**.

## Prasyarat

* `curl` telah terinstal
* **Kunci API KiosAPI** (diawali dengan `sk-`)

Atur kunci untuk shell saat ini:

```bash theme={null}
export KIOSAPI_KEY="sk-xxx"
```

Di Windows PowerShell:

```powershell theme={null}
$env:KIOSAPI_KEY = "sk-xxx"
```

> [!WARNING]
>
> Jangan commit kunci API ke source control atau menyimpannya dalam kode browser sisi klien.

## Chat Completions Kompatibel OpenAI

Gunakan URL dasar kompatibel OpenAI `https://kiosapi.com/v1`:

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

Teks yang dihasilkan dikembalikan dalam `choices[0].message.content`.

## Daftar Model Kompatibel OpenAI

```bash theme={null}
curl https://kiosapi.com/v1/models \
  -H "Authorization: Bearer $KIOSAPI_KEY"
```

Gunakan ID model yang dikembalikan endpoint ini pada permintaan berikutnya.

## Anthropic Messages API

Untuk permintaan yang kompatibel dengan Anthropic, gunakan `https://kiosapi.com/v1/messages`:

```bash theme={null}
curl https://kiosapi.com/v1/messages \
  -H "x-api-key: $KIOSAPI_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Say hello in Indonesian."}
    ]
  }'
```

Teks yang dihasilkan dikembalikan dalam array `content` pada respons.

## Gemini Generate Content API

Untuk permintaan yang kompatibel dengan Gemini, gunakan URL dasar Gemini `https://kiosapi.com/v1beta`:

```bash theme={null}
curl "https://kiosapi.com/v1beta/models/gemini-3.8-flash:generateContent?key=$KIOSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          {"text": "Say hello in Indonesian."}
        ]
      }
    ]
  }'
```

Teks yang dihasilkan dikembalikan dalam `candidates[0].content.parts[0].text`.

## Pemecahan Masalah

### 401 Unauthorized

* Pastikan kunci API diawali dengan `sk-`
* Pastikan variabel lingkungan tersedia: `echo $KIOSAPI_KEY`
* Buat kunci baru di Dashboard KiosAPI jika kunci sebelumnya dicabut

### Model tidak ditemukan

* Daftarkan model dengan `GET https://kiosapi.com/v1/models`
* Pastikan model yang dipilih termasuk dalam grup token Anda
* Periksa [model yang tersedia](https://docs.kiosapi.com/id/api-reference/models/list-models.md)

### Kesalahan endpoint

* Gunakan `https://kiosapi.com/v1` untuk endpoint yang kompatibel dengan OpenAI
* Gunakan `https://kiosapi.com/v1/messages` untuk permintaan Anthropic Messages
* Gunakan `https://kiosapi.com/v1beta` sebagai URL dasar Gemini

## Butuh Bantuan?

* [Dashboard KiosAPI](https://kiosapi.com)
* [Panduan autentikasi](https://docs.kiosapi.com/authentication.md)
* [Model Tersedia](https://docs.kiosapi.com/id/api-reference/models/list-models.md)


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