Developer Documentation

Dokumentasi JembatanAI Gateway

Setup Claude Code, Codex CLI, OpenCode, OpenAI SDK, dan Anthropic-compatible clients dengan satu API key. JembatanAI menyediakan Claude-compatible model aliases yang dirouting melalui backend JembatanAI Smart Routing seperti auto-free, fast-route, dan code-route.

Transparansi: JembatanAI bukan Anthropic dan bukan partner resmi Anthropic. Produk ini adalah gateway kompatibilitas yang menyajikan pengalaman Claude/OpenAI-compatible di atas routing model JembatanAI-managed. Client tetap memakai nama model Claude-compatible agar Claude Code/Codex/OpenCode tidak rusak.

Quick Start

  1. Buka Dashboard, login, lalu buat API key.
  2. Pilih flow: Claude Code, Codex CLI, OpenCode, OpenAI SDK, atau Anthropic SDK.
  3. Gunakan base URL JembatanAI dan API key berformat gw-....
Gateway Anthropic: https://gateway.jembatanai.com
Gateway OpenAI: https://gateway.jembatanai.com/v1

Claude Code

Claude Code memakai Anthropic Messages API. Script setup akan mengisi ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY, dan device id yang stabil.

Windows PowerShell

irm https://gateway.jembatanai.com/setup-claude.ps1 | iex

macOS / Linux

curl -fsSL https://gateway.jembatanai.com/setup-claude.sh | bash

Manual env:

export ANTHROPIC_API_KEY="gw-..."
export ANTHROPIC_BASE_URL="https://gateway.jembatanai.com"

Codex CLI

Codex memakai OpenAI Chat Completions. JembatanAI menerima model OpenAI umum dan menormalisasi ke alias Claude-compatible yang didukung gateway.

Windows PowerShell

irm https://gateway.jembatanai.com/setup-codex.ps1 | iex

macOS / Linux

curl -fsSL https://gateway.jembatanai.com/setup-codex.sh | bash

Config inti:

[model_providers.jembatanai]
base_url = "https://gateway.jembatanai.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat_completions"

OpenCode / OpenAI SDK

Untuk OpenCode atau SDK yang OpenAI-compatible, cukup ubah base URL dan API key.

export OPENAI_API_KEY="gw-..."
export OPENAI_BASE_URL="https://gateway.jembatanai.com/v1"
export OPENAI_MODEL="claude-sonnet-4-6"
const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://gateway.jembatanai.com/v1'
});

Model Aliases & Routing

User-facing model names dibuat Claude-compatible agar tooling tidak rusak. Di backend, model dirouting ke JembatanAI-managed aliases sesuai paket dan active model.

User-facing aliasBackend routingKegunaan
claude-haiku-4-5auto-freeCepat, hemat, cocok untuk tugas ringan dan iterasi cepat.
claude-sonnet-4-6auto-freeDefault seimbang untuk coding harian, refactor, dan chat agent.
claude-opus-4-7auto-free / active smart routeWorkload berat, reasoning, repo besar, dan production support.
auto-freeauto-freeRouter aktif/fallback yang memilih jalur free yang tersedia.
Marketing truth: Kami menjual pengalaman Claude-compatible untuk developer tools, bukan klaim kemitraan resmi Anthropic. Nama alias dipertahankan supaya Claude Code, Codex, dan OpenCode kompatibel.

Device, Quota, dan Plan

  • Paid plan memakai 1 active device per account untuk menjaga fairness.
  • Free plan memiliki limit harian; paid plan mengikuti konfigurasi plan aktif di dashboard.
  • Jika ganti device, device lama yang stale dapat diganti otomatis sesuai policy.
  • API key dapat dicabut dan dibuat ulang dari dashboard.

Troubleshooting

  • 401 authentication_error: cek API key, prefix gw-, dan env var.
  • 403 permission_error: model tidak tersedia di plan atau device limit tercapai.
  • 429 rate_limit_error: limit harian/traffic tercapai; tunggu reset atau upgrade.
  • Stream putus: ulangi request; gateway mengirim event error agar client tidak hang.
Telegram Support Baca FAQ