Clouvia RouterClouvia Router
StatusPanel

Referensi

Endpoint

Base URL produksi adalah https://router.clouvia.id/v1 dan mengikuti kontrak OpenAI.

MethodPathDeskripsi
POST/v1/chat/completionsInferensi chat, mendukung streaming SSE.
GET/v1/modelsKatalog model aktif beserta harga.
GET/v1/key/introspectStatus key, scope, dan sisa saldo.

Permintaan

http
1POST /v1/chat/completions2Content-Type: application/json34{5  "model": "clouvia-fast",6  "messages": [7    {"role": "system", "content": "Kamu asisten ringkas."},8    {"role": "user", "content": "Jelaskan routing API dalam satu kalimat."}9  ],10  "max_tokens": 256,11  "temperature": 0.7,12  "stream": false13}

Respons

json
1{2  "id": "chatcmpl-01J9X2K5T7QH",3  "object": "chat.completion",4  "model": "clouvia-fast",5  "choices": [6    {7      "index": 0,8      "message": {"role": "assistant", "content": "Routing API mengarahkan satu permintaan ke penyedia paling sehat."},9      "finish_reason": "stop"10    }11  ],12  "usage": {"prompt_tokens": 32, "completion_tokens": 18, "total_tokens": 50}13}

Streaming

Set stream true untuk menerima potongan SSE. Biaya dihitung setelah stream selesai dari usage upstream, atau estimasi tokenizer bila upstream tidak mengirimkannya.

bash
curl -N https://router.clouvia.id/v1/chat/completions \  -H "Authorization: Bearer $CLOUVIA_API_KEY" \  -H "Content-Type: application/json" \  -d '{"model":"clouvia-fast","messages":[{"role":"user","content":"halo"}],"stream":true}'

Katalog model

bash
curl https://router.clouvia.id/v1/models \  -H "Authorization: Bearer $CLOUVIA_API_KEY"

Header respons

  • X-Request-Id untuk korelasi tiket dukungan dengan baris usage_records.
  • X-Clouvia-Provider menunjukkan upstream yang benar-benar melayani.
  • X-Clouvia-Cost memuat biaya credit request tersebut.
  • RateLimit-Limit, RateLimit-Remaining, dan RateLimit-Reset pada setiap panggilan.