Platoware

Dokumentasi Platoware

Satu endpoint, satu API key, 26 model siap pakai — kompatibel penuh dengan OpenAI API.

Apa itu Platoware?#

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.

Tanpa ubah kode. Format request dan response sama seperti OpenAI /v1/chat/completions.

Langkah berikutnya#

Daftar model

26 model dengan konteks sampai 1 juta token.

Quickstart#

  1. Buat API key di dashboard.
  2. Ganti base URL ke https://router.platoware.space/v1.
  3. Kirim request seperti biasa.
bash
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"}]
  }'
python
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)

Autentikasi#

Semua request wajib membawa API key pada header Authorization:

http
Authorization: Bearer pware-xxxxx

Key bisa dibatasi kuota token dan masa aktif. Key yang salah atau nonaktif akan dibalas 401.

Model#

Klik nama model untuk menyalin. Semua model tersedia lewat endpoint yang sama.

ModelTipeKonteksAksi

Endpoint#

MethodPathKeterangan
POST/v1/chat/completionsChat completion (termasuk streaming)
POST/v1/completionsLegacy completion
GET/v1/modelsDaftar model yang tersedia

Base URL: https://router.platoware.space/v1

Parameter#

FieldTipeKeterangan
modelstringWajib. Nama model, mis. pware-qwen3.8-27b
messagesarrayWajib. role + content
streambooleanStreaming SSE. Default false
max_tokensintegerDiisi otomatis kalau kosong
temperaturenumber0–2
reasoning_effortstringModel reasoning: low, medium, high
toolsarrayFunction calling, format OpenAI

Error#

KodeArtiSolusi
401API key salah / nonaktifCek key, buat ulang di dashboard
402Kuota key habisTambah kuota atau pakai key lain
404Model tidak dikenalAmbil nama dari tabel model
429Rate limitBackoff lalu ulangi
502Provider sedang gangguanUlangi; gateway pindah provider otomatis

SDK & klien#

Karena formatnya OpenAI-compatible, semua SDK resmi OpenAI bisa dipakai:

  • Python — openai, set base_url
  • Node.js — openai, set baseURL
  • opencode / Cursor / Continue — tambah provider OpenAI-compatible
  • LangChain, LlamaIndex — pakai OpenAI adapter

FAQ#

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