📖 HidePulsa AI — API Documentation

Base URL (OpenAI-compatible): https://ai.hidepulsa.com/v1
Base URL (Anthropic-compatible): https://ai.hidepulsa.com
Auth: Authorization: Bearer YOUR_API_KEY

1. Mendapatkan API Key

Buka Telegram bot kami, ketik /start, lalu pilih paket yang diinginkan. Pembayaran via QRIS otomatis — API key langsung dikirim ke chat begitu pembayaran masuk.

🎁 Trial 15 menit — gratis, 1x per minggu
⚡ Daily — 1 hari — Rp 5.000
🔥 3-Day — 3 hari — Rp 15.000
💎 Weekly — 7 hari — Rp 35.000
👑 Monthly — 30 hari — Rp 60.000

2. Endpoints

Method	Path	Description
POST	`/v1/chat/completions`	Chat completion (streaming & non-streaming, OpenAI format)
POST	`/v1/messages`	Anthropic-format messages (Claude Code CLI)
POST	`/v1/responses`	OpenAI Responses (Codex CLI)
POST	`/v1/embeddings`	Embeddings (passthrough)
POST	`/v1/images/generations`	Image generation (text → image)
GET	`/v1/models`	List model yang aktif
GET	`/v1/usage`	Self-service: statistik pemakaian key

3. Model Tersedia (41)

Model ID	Display Name	Tag
`kr/claude-opus-4.7`	Claude Opus 4.7	👁 Vision (Weekly+)
`kr/claude-opus-4.6`	Claude Opus 4.6	👁 Vision (Weekly+)
`kr/claude-opus-4.5`	Claude Opus 4.5	👁 Vision (Weekly+)
`kr/claude-sonnet-4.5`	Claude Sonnet 4.5	👁 Vision (Weekly+)
`kr/claude-haiku-4.5`	Claude Haiku 4.5	👁 Vision (Weekly+)
`kr/deepseek-3.2`	DeepSeek 3.2	👁 Vision (Weekly+)
`kr/qwen3-coder-next`	Qwen 3 Coder Next	👁 Vision (Weekly+)
`kr/glm-5`	GLM 5	👁 Vision (Weekly+)
`kr/MiniMax-M2.5`	MiniMax M2.5	👁 Vision (Weekly+)
`openrouter/google/gemma-4-26b-a4b-it:free`	Gemma 4 26B (FREE Vision)	🆓 Vision
`openrouter/google/gemma-4-31b-it:free`	Gemma 4 31B (FREE Vision)	🆓 Vision
`openrouter/nvidia/nemotron-nano-12b-v2-vl:free`	Nemotron Nano 12B VL (FREE)	🆓 Vision
`openrouter/nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free`	Nemotron Omni 30B (FREE)	🆓 Vision
`kr/claude-haiku-4.5-thinking`	Claude Haiku 4.5 Thinking	👁 Vision (Weekly+)
`kr/claude-sonnet-4.5-agentic`	Claude Sonnet 4.5 Agentic	👁 Vision (Weekly+)
`kr/claude-haiku-4.5-agentic`	Claude Haiku 4.5 Agentic	👁 Vision (Weekly+)
`kr/claude-sonnet-4.5-thinking-agentic`	Claude Sonet 4.5 Thinking-Agentic	👁 Vision (Weekly+)
`kr/claude-haiku-4.5-thinking-agentic`	Claude Haiku 4.5 Thinking Agentic	👁 Vision (Weekly+)
`kr/claude-sonnet-4.5-thinking`	Claude Sonnet 4.5 Thinking	👁 Vision (Weekly+)
`gc/gemini-3-flash-preview`	Gemini 3 Flash Preview	👁 Vision (Weekly+)
`gc/gemini-3-pro-preview`	Gemini 3 Pro Preview	👁 Vision (Weekly+)
`kr/claude-sonnet-4`	Claude Sonnet 4	👁 Vision (Weekly+)
`ag/gemini-3.1-pro-high`	Gemini 3.1 Pro High	👁 Vision (Weekly+)
`ag/gemini-3.1-pro-low`	Gemini 3.1 Pro Low	👁 Vision (Weekly+)
`ag/gemini-3-flash`	Gemini 3 Flash	👁 Vision (Weekly+)
`ag/claude-sonnet-4-6`	Claude Sonnet 4.6	👁 Vision (Weekly+)
`ag/claude-opus-4-6-thinking`	Claude Opus 4.6 Thinking	👁 Vision (Weekly+)
`kr/claude-opus-4.8`	Claude Opus 4.8	👁 Vision (Weekly+)
`abb/deepseek-v4-pro`	Deepseek V4 Pro	👁 Vision (Weekly+)
`abb/qwen3.7-max`	Qweb 3.7 Max	📝 Text
`abb/deepseek-v4-flash`	Deepseek V4 Flash	👁 Vision (Weekly+)
`abb/glm-5.1`	GLM 5.1	👁 Vision (Weekly+)
`abb/qwen3.7-max-2026-05-17`	Qwen 3.7 max-2026-05-17	📝 Text
`abb/qwen3.6-plus`	Qwen 3.6 Plus	👁 Vision (Weekly+)
`abb/qwen3.5-plus`	Qwen 3.5 Plus	👁 Vision (Weekly+)
`abb/qwen3.5-flash`	Qwen 3.5 Flash	👁 Vision (Weekly+)
`abb/qwen3.6-flash`	Qwen 3.6 Flash	👁 Vision (Weekly+)
`pi/claude-opus-4-8`	PI Claude Opus 4.8	👁 Vision (Weekly+)
`pi/claude-opus-4-7`	PI Claude Opus 4.7	👁 Vision (Weekly+)
`pi/claude-opus-4-6`	PI Claude Opus 4.6	👁 Vision (Weekly+)
`pi/claude-opus-4-5`	PI Claude Opus 4.5	👁 Vision (Weekly+)

4. Quick Start

🌐 cURL

curl https://ai.hidepulsa.com/v1/chat/completions \
  -H "Authorization: Bearer sk-kr-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kr/claude-opus-4.7",
    "messages": [
      {"role":"user","content":"Halo, apa kabar?"}
    ]
  }'

🐍 Python (openai lib)

pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="sk-kr-xxxxxxxx",
    base_url="https://ai.hidepulsa.com/v1",
)

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

🟨 Node.js (openai lib)

npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-kr-xxxxxxxx",
  baseURL: "https://ai.hidepulsa.com/v1",
});

const r = await client.chat.completions.create({
  model: "kr/claude-opus-4.7",
  messages: [{ role: "user", content: "Halo!" }],
});
console.log(r.choices[0].message.content);

🔌 Cline / Continue.dev / Cursor

Pilih provider OpenAI Compatible dan isi:

Base URL: https://ai.hidepulsa.com/v1
API Key: sk-kr-xxxxxxxx
Model: kr/claude-opus-4.7 (atau lainnya dari /v1/models)

5. Streaming (SSE)

Tambahkan stream: true di body request:

curl https://ai.hidepulsa.com/v1/chat/completions \
  -H "Authorization: Bearer sk-kr-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kr/claude-opus-4.7",
    "messages": [{"role":"user","content":"tulis puisi pendek"}],
    "stream": true
  }'

6. Vision & OCR (Multimodal)

Kirim gambar bareng text prompt — pakai endpoint /v1/chat/completions. Model dengan akhiran :free bisa dipakai semua tier; model premium (cx/*) butuh paket Weekly atau Monthly.

Daily image cap per tier: Trial 5 · Daily 999 · 3-Day 10000 · Weekly 10000 · Monthly 10000 images/day.

7. Cek Usage (Self-Service)

curl https://ai.hidepulsa.com/v1/usage \
  -H "Authorization: Bearer sk-kr-xxxxxxxx"

Response contoh:

{
  "key_info": {
    "package": "weekly",
    "status": "active",
    "expires_at": "2026-05-18T14:23:00.000Z",
    "seconds_remaining": 529440
  },
  "total_usage": {
    "requests": 312,
    "prompt_tokens": 124552,
    "completion_tokens": 417835,
    "total_tokens": 542387
  },
  "last_24h": { "requests": 47, "total_tokens": 82104 },
  "by_model": {
    "kr/claude-opus-4.7": { "requests": 201, "total_tokens": 312432 }
  },
  "rate_limit": {
    "rpm": 60,
    "remaining_this_minute": 58,
    "concurrency_limit": 5
  }
}

8. Error Codes

Status	Code	Meaning
401	`missing_api_key`	Header Authorization tidak ada
401	`invalid_api_key`	Key tidak ditemukan
401	`api_key_expired`	Key sudah expired, perpanjang dulu
401	`api_key_revoked`	Key sudah direvoke admin
400	`model_not_found`	Model tidak ada di whitelist
400	`model_not_multimodal`	Model text-only kena image input
403	`paid_vision_requires_upgrade`	Paid vision butuh paket Weekly+
429	`rate_limit_rpm`	Melebihi request per menit
429	`rate_limit_concurrency`	Terlalu banyak request concurrent
429	`image_cap_exceeded`	Daily image cap habis
429	`daily_token_cap`	Melebihi token cap harian
502	`upstream_error`	Problem di upstream LLM

9. Best Practices

Gunakan streaming (stream: true) untuk response interaktif.
Simpan key di environment variable, jangan hardcode.
Cek /v1/usage sebelum expired untuk tahu kapan perpanjang.
Hormati rate limit 60 RPM — jangan spam request.

Butuh bantuan? Chat admin di Telegram • home