// Quick Start

Dokumentasi

Konfigurasikan titik akhir dan kunci API Anda melalui variabel lingkungan — tidak diperlukan perubahan kode untuk mengintegrasikan AnBoWork.

PLUGIN
Ingin membuat plugin untuk aplikasi desktop AnBoWork (menambahkan alat untuk AI, memasang panel samping, mengirim notifikasi sistem)?Dokumen pengembang plugin

01Titik Akhir API

Anthropic SDK (Claude Code dll.)
https://api.anbowork.com
OpenAI SDK/HTTP
https://api.anbowork.com/v1
KEY
Buat kunci di konsol di bawah "Manajemen Kunci API". Sepertinya sk-kunci-api-Anda. Berikan dalam permintaan sebagai Otorisasi: Pembawa sk-...

02Variabel Lingkungan

Windows Pengaturan

Berlaku hanya untuk sesi terminal saat ini. Menutup saat jendela ditutup. Bagus untuk pengujian cepat.

# PowerShell (valid for current session only)
$env:ANTHROPIC_BASE_URL = "https://api.anbowork.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-api-key"

macOS / Linux Pengaturan

Berlaku hanya untuk sesi terminal saat ini. Menutup saat jendela ditutup. Bagus untuk pengujian cepat.

# bash / zsh (valid for current session only)
export ANTHROPIC_BASE_URL="https://api.anbowork.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

03Integrasi Alat

Alat pengkodean AI arus utama dapat terhubung langsung ke AnBoWork — cukup atur variabel lingkungan atau konfigurasi di bawah.

Claude Code CLI

CLI resmi Anthropic — terhubung ke AnBoWork melalui variabel lingkungan, tidak perlu perubahan kode.

Buka Manajemen Kunci API untuk mengunduh skrip pengaturan sekali klik →
# bash / zsh (valid for current session only)
export ANTHROPIC_BASE_URL="https://api.anbowork.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

Kemudian luncurkan dengan:

claude

Codex CLI

OpenAI resmi Codex CLI — menggunakan titik akhir /v1/responses. Catatan: base_url harus menyertakan /v1.

Sunting ~/.codex/config.toml:

model_provider = "piomodel"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.piomodel]
name = "piomodel"
base_url = "https://api.anbowork.com/v1"
wire_api = "responses"
env_key = "PIOMODEL_API_KEY"

Kemudian atur kunci API sebagai variabel lingkungan:

# bash / zsh
export PIOMODEL_API_KEY="sk-your-api-key"

Kemudian luncurkan dengan:

codex

Cursor / Selancar Angin

Ganti titik akhir OpenAI dan kunci API di pengaturan.

{
  "openai.baseUrl": "https://api.anbowork.com/v1",
  "openai.apiKey": "sk-your-api-key"
}

Cline (Kode VS)

Pilih OpenAI Penyedia yang kompatibel di Cline dan masukkan titik akhir, kunci, dan nama model.

Provider   : OpenAI Compatible
Base URL   : https://api.anbowork.com/v1
API Key    : sk-your-api-key
Model      : claude-sonnet-4-5-20250929

04Contoh Kode

from anthropic import Anthropic

# Automatically reads ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN from env
client = Anthropic()

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content[0].text)

Memasang: pip install anthropic / openai · npm install openai

05Mengalir

Tambahkan aliran: sesuai dengan isi permintaan Anda untuk mengaktifkan streaming SSE — ideal untuk UI obrolan waktu nyata.

from anthropic import Anthropic

client = Anthropic()

with client.messages.stream(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Write a haiku about Go."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

06Konversi Format Otomatis

AnBoWork melakukan konversi dua arah transparan antara Anthropic Pesan dan OpenAI Obrolan di tingkat gateway. Ini berarti Anda dapat memanggil model yang sama dengan gaya Anthropic atau gaya OpenAI — satu basis kode, model apa pun.

Pemetaan bidang utama antara kedua gaya:

Anthropic GayaOpenAI GayaKeterangan
systemmessages[role=system]Perintah sistem diposisikan berbeda; gateway menanganinya secara otomatis
max_tokens(必填)max_tokens(可选)Jika dihilangkan, gateway akan menerapkan batas default model
content 分块数组content 字符串Blok teks/gambar dikonversi ke dan dari string
stop_reasonfinish_reasonSelesaikan pemetaan nama bidang alasan
TIP
Sudah punya kode OpenAI dan ingin menelepon Claude? Cukup ubah base_url dan model — tidak perlu menyentuh struktur pesan.

07Multimoda

Pembuatan gambar menggunakan gateway dan kunci API yang sama, ditagih berdasarkan penggunaan.

img = client.images.generate(
    model="gpt-image-2",
    prompt="夜幕下的城市天际线,电影感",
    size="1024x1024",
)
print(img.data[0].url)

08Pemanggilan Fungsi

Tentukan fungsi yang dapat dipanggil menggunakan alat bergaya OpenAI. Model mengembalikan tool_calls bila diperlukan, dan kode Anda mengeksekusinya dan mengembalikan hasilnya.

tools = [{
  "type": "function",
  "function": {
    "name": "get_weather",
    "description": "查询某城市天气",
    "parameters": {
      "type": "object",
      "properties": {"city": {"type": "string"}},
      "required": ["city"],
    },
  },
}]

resp = client.chat.completions.create(
    model="claude-sonnet-4-5-20250929",
    messages=[{"role": "user", "content": "上海今天天气怎么样?"}],
    tools=tools,
)
print(resp.choices[0].message.tool_calls)

09Penanganan Kesalahan

/v1/* titik akhir mengikuti format kesalahan OpenAI — tanggapan berisi tipe / kode / pesan.

{
  "error": {
    "type": "invalid_request_error",
    "code": "insufficient_quota",
    "message": "余额不足"
  }
}

Kode kesalahan umum

HTTPKeterangan
401Kunci API tidak valid atau hilang
402Saldo tidak mencukupi — harap isi ulang
429Tarif terbatas atau kuota harian habis
503Semua saluran hulu tidak tersedia (sirkuit rusak)
Lihat semua model dan harga →