BluePack API Documentation

Pengenalan

BluePack menyediakan endpoint kompatibel untuk berbagai AI coding tools dengan API key berformat bluepack_.... Anda cukup mengubah base_url dan API key pada tool yang digunakan.

Quickstart

Tiga langkah untuk mulai menggunakan BluePack:

1. Dapatkan API Key Login ke Member Dashboard, buat subscription, lalu salin API key berformat bluepack_... dari halaman API Keys.
2. Set Base URL Gunakan https://ai.bluepack.my.id/v1 untuk OpenAI-compatible, https://ai.bluepack.my.id/anthropic untuk Claude Code, atau https://ai.bluepack.my.id/codex/v1 untuk Codex CLI.
3. Kirim Permintaan Sertakan header Authorization: Bearer bluepack_... dan mulai mengirim chat.

Contoh cURL

curl https://ai.bluepack.my.id/v1/chat/completions \
  -H "Authorization: Bearer bluepack_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bluepack-coding",
    "messages": [{"role": "user", "content": "Halo!"}]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.bluepack.my.id/v1",
    api_key="bluepack_xxx",
)

resp = client.chat.completions.create(
    model="bluepack-coding",
    messages=[{"role": "user", "content": "Halo!"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://ai.bluepack.my.id/v1",
  apiKey: "bluepack_xxx",
});

const resp = await client.chat.completions.create({
  model: "bluepack-coding",
  messages: [{ role: "user", content: "Halo!" }],
});
console.log(resp.choices[0].message.content);

Autentikasi

Semua permintaan ke endpoint proxy memerlukan API key BluePack. Kirim via header Authorization: Bearer bluepack_... atau header x-api-key: bluepack_... (untuk kompatibilitas Anthropic SDK).

Format API Key

bluepack_<32 karakter alfanumerik>

Base URL & Prefix

BluePack menyediakan beberapa prefix agar kompatibel dengan berbagai SDK:

Chat Completions

Endpoint OpenAI-style untuk percakapan.

POST /v1/chat/completions  ·  /chat/completions  ·  /codex/v1/chat/completions

Parameter Utama

Contoh Respons

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "bluepack-coding",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Halo! Ada yang bisa saya bantu?" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 10, "completion_tokens": 8, "total_tokens": 18 }
}

Anthropic Messages

Endpoint asli Anthropic untuk Claude SDK & Claude Code.

POST /v1/messages  ·  /messages  ·  /anthropic/v1/messages

Responses API

Endpoint /v1/responses untuk Codex CLI & OpenAI Responses API.

POST /v1/responses  ·  /codex/v1/responses

Count Tokens

Menghitung estimasi token input tanpa memproses permintaan.

POST /v1/messages/count_tokens  ·  /messages/count_tokens  ·  /anthropic/v1/messages/count_tokens

Usage Endpoint

Mendapatkan info pemakaian untuk API key yang sedang digunakan.

GET /v1/usage

Untuk pengecekan publik via UI, gunakan halaman Cek Usage.

Rate Limit & Kuota

BluePack menerapkan dua jendela kuota: 5 jam (rolling) dan 7 hari (mingguan). Batas bergantung pada plan subscription Anda.

Bagaimana paket tambahan bekerja?

Error Handling

BluePack mengembalikan kode HTTP standar dengan body JSON {"error": "..."}.

Streaming

Set "stream": true pada body untuk menerima respons bertahap (SSE). Format event mengikuti standar masing-masing provider (OpenAI chat.completion.chunk atau Anthropic message_delta).

curl -N https://ai.bluepack.my.id/v1/chat/completions \
  -H "Authorization: Bearer bluepack_xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"bluepack-coding","stream":true,"messages":[{"role":"user","content":"Hitung 1-5"}]}'

Kompatibilitas

BluePack mendukung format berikut tanpa perubahan kode SDK:

• OpenAI — /v1/chat/completions, /v1/responses, /v1/models
• Anthropic — /v1/messages, /v1/messages/count_tokens
• Ollama — /api/chat, /api/tags
• Generic — /messages, /chat/completions (tanpa prefix)

Claude Code

Gunakan endpoint Anthropic-compatible BluePack. Video berikut dapat langsung diputar tanpa meninggalkan dokumentasi.

Konfigurasi endpoint

export ANTHROPIC_BASE_URL=https://ai.bluepack.my.id/anthropic
export ANTHROPIC_API_KEY=bluepack_xxx
claude

Codex CLI

Generator ini memasang Codex CLI, membackup konfigurasi lama, lalu mengarahkan endpoint ke BluePack.

Tools: Cline

Di VS Code, set provider ke Anthropic atau OpenAI Compatible, lalu isi base URL & API key BluePack Anda.

MultiTools

Gunakan base URL https://ai.bluepack.my.id/v1 pada tool yang mendukung OpenAI-compatible API.

Tool yang didukung

Kilo Code

Ekstensi VS Code multi-provider.

Lihat tutorial

Hermes Agent

Agent AI dengan custom endpoint.

Lihat tutorial

OpenClaw

Open-source coding agent.

Lihat tutorial

Troubleshooting

Mulai dari status HTTP atau gejala yang terlihat. Jangan mengirim API key penuh, password, prompt, atau response pribadi saat meminta bantuan.

FAQ

Changelog