# Integrasi AdellRoute

<img src="/logo-light.svg" alt="" className="hero-logo dark:hidden" />
<img src="/logo-dark.svg" alt="" className="hero-logo hidden dark:block" />

<p className="hero-sub">Semua tool populer bisa memakai AdellRoute lewat format OpenAI atau Anthropic. Pilih tool kamu di bawah.</p>

<details className="sec" open>
<summary>

## <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="lucide lucide-package sec-ico" aria-hidden="true"><path d="M11 21.73a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73z"></path><path d="M12 22V12"></path><polyline points="3.29 7 12 12 20.71 7"></polyline><path d="m7.5 4.27 9 5.15"></path></svg>OpenAI SDK

<p className="sec-sub">Pakai OpenAI SDK (Python & Node) dengan AdellRoute: ganti base_url ke https://api.adellroute.work/v1 dan sertakan API key sk-....</p>

</summary>

AdellRoute kompatibel dengan OpenAI API, jadi OpenAI SDK bisa dipakai langsung. Cukup ganti `base_url` (atau `baseURL`) dan sertakan API key.

```python
from openai import OpenAI

client = OpenAI(base_url="https://api.adellroute.work/v1", api_key="sk-...")

# Chat Completions
resp = client.chat.completions.create(
    model="gemini-3.5-flash",
    messages=[
        {"role": "system", "content": "Kamu asisten yang ringkas."},
        {"role": "user", "content": "Apa ibu kota Kalimantan Timur?"},
    ],
)
print(resp.choices[0].message.content)

# Responses API
r = client.responses.create(model="gpt-5-mini", input="Ringkas berita ini dalam 3 poin: ...")
print(r.output_text)

# Embeddings
e = client.embeddings.create(model="text-embedding-3-small", input=["halo dunia"])
print(len(e.data[0].embedding))
```

```ts
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.adellroute.work/v1",
  apiKey: process.env.ADELLROUTE_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Buat 3 ide nama kedai kopi" }],
});
console.log(resp.choices[0].message.content);
```

Semua model (termasuk Claude, Gemini, DeepSeek) bisa dipanggil lewat format OpenAI.

### Gambar (vision)

Untuk model yang mendukung vision, kirim gambar sebagai `image_url` (URL publik atau data URL base64):

```python
resp = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Apa isi gambar ini?"},
            {"type": "image_url", "image_url": {"url": "data:image/png;base64,iVBOR..."}},
        ],
    }],
)
```

### Tool calling / function calling

Didukung di model yang mendukungnya, dengan format OpenAI (`tools`, `tool_choice`) yang sama persis.

Model yang tidak punya Responses API di AdellRoute otomatis dilayani lewat Chat Completions, jadi `client.responses.create` tetap jalan untuk semua model chat.

Nama model persis seperti yang tertera di `GET /v1/models` atau halaman **Models** di dashboard.

</details>

<details className="sec">
<summary>

## <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="lucide lucide-bot sec-ico" aria-hidden="true"><path d="M12 8V4H8"></path><rect width="16" height="12" x="4" y="8" rx="2"></rect><path d="M2 14h2"></path><path d="M20 14h2"></path><path d="M15 13v2"></path><path d="M9 13v2"></path></svg>Anthropic SDK

<p className="sec-sub">Pakai Anthropic SDK (Python & TypeScript) dengan AdellRoute lewat POST /v1/messages, juga untuk model non-Claude.</p>

</summary>

AdellRoute menyediakan `POST /v1/messages` yang kompatibel dengan Anthropic Messages API. Endpoint ini bisa dipakai untuk **semua model chat**, bukan hanya Claude: request diterjemahkan otomatis.

Base URL untuk Anthropic SDK **tanpa** `/v1`, karena SDK menambahkannya sendiri.

```python
import anthropic

client = anthropic.Anthropic(base_url="https://api.adellroute.work", api_key="sk-...")

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Jelaskan rekursi dengan analogi sederhana"}],
)
print(msg.content[0].text)
```

```ts
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.adellroute.work",
  apiKey: process.env.ADELLROUTE_API_KEY,
});

const msg = await client.messages.create({
  model: "deepseek-v4-pro",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Halo!" }],
});
```

### Extended thinking

```python
msg = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    thinking={"type": "enabled", "budget_tokens": 2048},
    messages=[{"role": "user", "content": "Buktikan bahwa akar 2 irasional"}],
)
```

### Hitung token

`POST /v1/messages/count_tokens` mengembalikan **estimasi** `input_tokens` dan tidak ditagih.

```python
client.messages.count_tokens(model="claude-sonnet-5", messages=[{"role": "user", "content": "Halo"}])
```

</details>

<details className="sec">
<summary>

## <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="lucide lucide-terminal sec-ico" aria-hidden="true"><path d="M12 19h8"></path><path d="m4 17 6-6-6-6"></path></svg>Claude Code

<p className="sec-sub">Hubungkan Claude Code ke AdellRoute lewat endpoint Anthropic Messages dengan ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN.</p>

</summary>

[Claude Code](https://docs.anthropic.com/claude-code) bisa memakai AdellRoute lewat endpoint Anthropic Messages.

```bash
export ANTHROPIC_BASE_URL="https://api.adellroute.work"      # tanpa /v1
export ANTHROPIC_AUTH_TOKEN="sk-..."
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
claude
```

Supaya permanen, simpan di `~/.claude/settings.json`:

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.adellroute.work",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}
```

### Pakai model non-Claude

Karena request diterjemahkan, Claude Code juga bisa jalan dengan model lain, misalnya:

```bash
export ANTHROPIC_MODEL="glm-5.3"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
```

Hasilnya tergantung kemampuan tool calling model tersebut.

### Tips

- Buat **API key khusus** Claude Code dengan batas kredit harian supaya pengeluaran terkontrol.
- Sesi agent yang panjang sangat diuntungkan oleh prompt caching: lihat kolom *cache read* di **Usage**.
- Request body sampai 32 MB didukung (sesi panjang dengan gambar).

</details>

<details className="sec">
<summary>

## <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="lucide lucide-square-terminal lucide-terminal-square sec-ico" aria-hidden="true"><path d="m7 11 2-2-2-2"></path><path d="M11 13h4"></path><rect width="18" height="18" x="3" y="3" rx="2" ry="2"></rect></svg>Codex

<p className="sec-sub">Pakai OpenAI Codex CLI dengan AdellRoute lewat provider kustom di config.toml.</p>

</summary>

Codex CLI membaca provider kustom dari `~/.codex/config.toml`. Arahkan ke AdellRoute lewat wire API Responses:

```toml
model = "gpt-5-codex"
model_provider = "adellroute"

[model_providers.adellroute]
name = "AdellRoute"
base_url = "https://api.adellroute.work/v1"
env_key = "ADELLROUTE_API_KEY"
wire_api = "responses"
```

```bash
export ADELLROUTE_API_KEY="sk-..."
codex
```

Ganti `model` sesuai nama dari `GET /v1/models`. Bila lingkungan kamu hanya mendukung Chat Completions, set `wire_api = "chat"`.

</details>

<details className="sec">
<summary>

## <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="lucide lucide-mouse-pointer-2 sec-ico" aria-hidden="true"><path d="M4.037 4.688a.495.495 0 0 1 .651-.651l16 6.5a.5.5 0 0 1-.063.947l-6.124 1.58a2 2 0 0 0-1.438 1.435l-1.579 6.126a.5.5 0 0 1-.947.063z"></path></svg>Cursor

<p className="sec-sub">Arahkan Cursor ke AdellRoute lewat Override OpenAI Base URL dan API key AdellRoute.</p>

</summary>

Di **Settings → Models**: aktifkan **Override OpenAI Base URL** dan isi `https://api.adellroute.work/v1`, lalu masukkan API key `sk-…` pada kolom OpenAI API Key. Tambahkan nama model dari `GET /v1/models` (mis. `gpt-5-mini`) lewat **Add model**, lalu pilih model itu di chat.

:::note
Model kustom berjalan lewat base URL kamu. Fitur bawaan Cursor yang memakai server Cursor tidak terpengaruh pengaturan ini.
:::

</details>

<details className="sec">
<summary>

## <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="lucide lucide-code sec-ico" aria-hidden="true"><path d="m16 18 6-6-6-6"></path><path d="m8 6-6 6 6 6"></path></svg>OpenCode

<p className="sec-sub">Daftarkan AdellRoute sebagai provider openai-compatible di opencode.json.</p>

</summary>

Tambahkan provider kustom di `opencode.json` (projek) atau `~/.config/opencode/opencode.json` (global):

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "adellroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AdellRoute",
      "options": {
        "baseURL": "https://api.adellroute.work/v1",
        "apiKey": "{env:ADELLROUTE_API_KEY}"
      },
      "models": {
        "gpt-5-mini": { "name": "GPT-5 Mini" },
        "claude-haiku-4-5": { "name": "Claude Haiku 4.5" }
      }
    }
  }
}
```

```bash
export ADELLROUTE_API_KEY="sk-..."
opencode
```

Pilih model lewat `/models`. Tambah entri `models` lain sesuai `GET /v1/models`.

</details>

<details className="sec">
<summary>

## <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="lucide lucide-wrench sec-ico" aria-hidden="true"><path d="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.106-3.105c.32-.322.863-.22.983.218a6 6 0 0 1-8.259 7.057l-7.91 7.91a1 1 0 0 1-2.999-3l7.91-7.91a6 6 0 0 1 7.057-8.259c.438.12.54.662.219.984z"></path></svg>Tool Lain

<p className="sec-sub">Resep universal untuk tool apa pun yang kompatibel dengan OpenAI atau Anthropic: base URL, API key, dan contoh konfigurasi.</p>

</summary>

Tool apa pun yang menerima provider kustom OpenAI atau Anthropic bisa memakai AdellRoute dengan dua resep berikut — tanpa integrasi khusus per tool.

### Resep OpenAI-compatible

| Pengaturan | Nilai |
| --- | --- |
| Base URL | `https://api.adellroute.work/v1` |
| API key | `sk-…` dari dashboard (env `ADELLROUTE_API_KEY`) |
| Model | Nama persis dari `GET /v1/models` |

Di mana pun tool meminta "OpenAI base URL" dan "API key", isi nilai di atas. Contoh bentuk umum:

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.adellroute.work/v1",
    api_key=os.environ["ADELLROUTE_API_KEY"],
)
```

### Resep Anthropic-compatible

| Pengaturan | Nilai |
| --- | --- |
| Base URL | `https://api.adellroute.work` (tanpa `/v1`) |
| Auth | `ANTHROPIC_AUTH_TOKEN=sk-…` (atau header `x-api-key` dengan key yang sama) |

```bash
export ANTHROPIC_BASE_URL="https://api.adellroute.work"
export ANTHROPIC_AUTH_TOKEN="sk-..."
```

### Checklist umum

- Header auth: `Authorization: Bearer <key>` (OpenAI) atau `x-api-key` / Bearer (Anthropic).
- Nama model harus persis dari `GET /v1/models`; salah nama = `404`.
- `401` = key salah/dicabut; `402` = saldo atau batas kredit habis — lihat seksi [Error](/introduction#error).
- Jangan taruh key di kode frontend/browser; panggil dari server atau tool desktop.

</details>
