Quickstart
Mulai dalam 5 menit — buat key, kirim request pertama.
Satu endpoint, satu API key, 26 model siap pakai — kompatibel penuh dengan OpenAI API.
Platoware adalah gateway OpenAI-compatible. Kamu memakai SDK atau tool apa pun yang sudah mendukung OpenAI, cukup ganti base URL dan API key. Gateway yang memilih provider sehat dan model yang tersedia di belakang layar.
/v1/chat/completions.Quickstart
Mulai dalam 5 menit — buat key, kirim request pertama.
Autentikasi
Cara membuat API key dan mengirim header Authorization.
Daftar model
26 model dengan konteks sampai 1 juta token.
Referensi API
Endpoint dan parameter lengkap beserta kode error.
https://router.platoware.space/v1.curl https://router.platoware.space/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $PLATOWARE_API_KEY" \ -d '{ "model": "pware-qwen3.8-27b", "messages": [{"role": "user", "content": "Halo"}] }'
from openai import OpenAI client = OpenAI( base_url="https://router.platoware.space/v1", api_key="pware-...", ) r = client.chat.completions.create( model="pware-qwen3.8-27b", messages=[{"role": "user", "content": "Halo"}], ) print(r.choices[0].message.content)
Semua request wajib membawa API key pada header Authorization:
Authorization: Bearer pware-xxxxx
Key bisa dibatasi kuota token dan masa aktif. Key yang salah atau nonaktif akan dibalas 401.
Klik nama model untuk menyalin. Semua model tersedia lewat endpoint yang sama.
| Model | Tipe | Konteks | Aksi |
|---|
| Method | Path | Keterangan |
|---|---|---|
| POST | /v1/chat/completions | Chat completion (termasuk streaming) |
| POST | /v1/completions | Legacy completion |
| GET | /v1/models | Daftar model yang tersedia |
Base URL: https://router.platoware.space/v1
| Field | Tipe | Keterangan |
|---|---|---|
| model | string | Wajib. Nama model, mis. pware-qwen3.8-27b |
| messages | array | Wajib. role + content |
| stream | boolean | Streaming SSE. Default false |
| max_tokens | integer | Diisi otomatis kalau kosong |
| temperature | number | 0–2 |
| reasoning_effort | string | Model reasoning: low, medium, high |
| tools | array | Function calling, format OpenAI |
| Kode | Arti | Solusi |
|---|---|---|
| 401 | API key salah / nonaktif | Cek key, buat ulang di dashboard |
| 402 | Kuota key habis | Tambah kuota atau pakai key lain |
| 404 | Model tidak dikenal | Ambil nama dari tabel model |
| 429 | Rate limit | Backoff lalu ulangi |
| 502 | Provider sedang gangguan | Ulangi; gateway pindah provider otomatis |
Karena formatnya OpenAI-compatible, semua SDK resmi OpenAI bisa dipakai:
openai, set base_urlopenai, set baseURLOpenAI adapterApakah streaming didukung? Ya, stream: true mengembalikan SSE seperti OpenAI.
Kenapa jawaban kosong? Untuk model reasoning, isi max_tokens minimal 256.
Bisa ganti model di tengah chat? Bisa, riwayat pesan tetap dikirim ulang oleh klien.