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

# Autentikasi

> Cara Triw memverifikasi request, dan header mana yang dipakai tiap protokol.

Setiap request memerlukan API key dari console. Satu key berlaku untuk semua protokol kompatibel — OpenAI, Anthropic, Gemini — karena Triw membaca key dari header yang lazim dipakai protokol tersebut.

## Header yang diterima

| Protokol | Header | Catatan |
| - | - | - |
| Gaya OpenAI | `Authorization: Bearer sk-...` | Utama, bisa dipakai di semua endpoint |
| Gaya Anthropic | `x-api-key: sk-...` | Diterima di `/v1/messages` |
| Gaya Gemini | `x-goog-api-key: sk-...` | Diterima di `/v1beta/...` |

Bila mengirim lebih dari satu, `Authorization` yang dipakai.

```bash theme={null}
curl https://router.triw.io/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"ping"}]}'
```

## Format dan cakupan key

* Key berawalan `sk-` dan dibuat per akun, bukan per model.
* Key mewarisi **grup** dan **kuota** yang Anda set saat membuatnya, plus masa berlaku dan allow-list model bila diisi.
* Key ditampilkan di console. Perlakukan seperti password; kalau bocor, rotasi segera — lihat [API keys](https://docs.triw.io/id/api-keys.md).

## Yang bukan API key

* Cookie sesi console (login browser) tidak berlaku untuk `/v1/*`.
* Key provider (OpenAI, Anthropic, Google) tidak bisa dipakai di Triw. Hanya key Triw yang diterima.

## Perilaku saat gagal

Key tidak ada, salah format, kedaluwarsa, dinonaktifkan, atau kuotanya habis akan mengembalikan HTTP `401`/`403` dengan `code` `invalid_api_key` atau `insufficient_user_quota`. Tabel lengkap: [Error](https://docs.triw.io/id/errors.md). Daftar route per protokol: [Endpoint](https://docs.triw.io/id/endpoints.md).


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