Dokumentasi
Endpoint kami kompatibel dengan OpenAI. Kalau aplikasimu bisa pakai OpenAI, tinggal ganti base URL dan API key. Tidak perlu ubah kode lain.
Mulai cepat
- Beli paket. API key dibuat otomatis begitu pembayaran masuk.
- Salin API key dari halaman API Key.
- Kirim request pertama ke
https://pocketstream.web.id/v1/chat/completions.
curl https://pocketstream.web.id/v1/chat/completions \
-H "Authorization: Bearer ps-xxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4.1-flash",
"messages": [{"role": "user", "content": "Halo"}]
}'
Autentikasi
Setiap request wajib membawa API key di header Authorization dengan format Bearer <key>. Key berbentuk ps- diikuti 24 karakter heksadesimal.
Jangan taruh key di kode frontend atau repositori publik. Kalau key bocor, hubungi admin untuk penerbitan ulang.
Model
Daftar model aktif bisa diambil kapan saja:
curl https://pocketstream.web.id/v1/models \
-H "Authorization: Bearer ps-xxxxx"
Katalog saat ini:
- Belum ada model aktif. Admin sedang menyiapkan katalog.
Nama model yang dipakai di request harus persis sama dengan yang ada di daftar. Salah satu huruf saja akan ditolak.
Chat completion
Body request mengikuti format OpenAI. Field yang didukung: model, messages, temperature, max_tokens, top_p, stream, stop.
POST https://pocketstream.web.id/v1/chat/completions
{
"model": "deepseek-v4.1-flash",
"messages": [
{"role": "system", "content": "Kamu asisten yang ringkas."},
{"role": "user", "content": "Jelaskan HTTP/2 dalam dua kalimat."}
],
"temperature": 0.7,
"max_tokens": 500
}
Balasan berisi choices[0].message.content plus usage berisi jumlah token prompt dan completion.
Streaming
Tambahkan "stream": true untuk menerima Server-Sent Events. Format chunk sama dengan OpenAI: setiap baris diawali data: , diakhiri data: [DONE].
curl -N https://pocketstream.web.id/v1/chat/completions \
-H "Authorization: Bearer ps-xxxxx" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"Hitung 1 sampai 5"}],"stream":true}'
Error
Semua error balik dalam bentuk JSON dengan field error.message.
401— API key tidak valid atau tidak dikirim.403— tiket tidak aktif, masa aktif habis, atau kuota habis.429— request melebihi batas per menit. Tunggu sebentar, lalu ulangi.503— semua upstream sedang sibuk. Coba lagi 30 detik.
Kalau dapat 403 dengan pesan kuota habis, tambah paket dari akun. Tiket aktif otomatis setelah pembayaran masuk.
Batas & kuota
Tiga hal yang membatasi pemakaian:
- Token. Setiap request memotong kuota sesuai token yang benar-benar dipakai.
- Jumlah request. Batas total per paket, bukan per hari.
- Kecepatan. 10, 20, atau 30 request per menit tergantung paket terakhir yang dibeli.
Maksimal 2 request berjalan bersamaan per akun. Request ketiga akan menunggu, bukan ditolak.
Integrasi
Python
from openai import OpenAI
client = OpenAI(
base_url="https://pocketstream.web.id/v1",
api_key="ps-xxxxx"
)
r = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "Halo"}]
)
print(r.choices[0].message.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://pocketstream.web.id/v1",
apiKey: "ps-xxxxx"
});
const r = await client.chat.completions.create({
model: "deepseek-v4.1-flash",
messages: [{ role: "user", content: "Halo" }]
});
console.log(r.choices[0].message.content);
Cursor
Settings → Models → OpenAI API Key. Isi key PocketStream, lalu aktifkan Override OpenAI Base URL dengan https://pocketstream.web.id/v1. Tambahkan nama model secara manual karena katalog Cursor berbeda.
Cline / Roo Code
Pilih provider OpenAI Compatible, isi base URL https://pocketstream.web.id/v1, API key PocketStream, dan nama model dari daftar di atas.
Cherry Studio
Settings → Model Providers → OpenAI → tambah provider baru. Isi API host https://pocketstream.web.id/v1 dan API key, lalu klik Check untuk menarik daftar model.