// Quick Start

Tài liệu

Định cấu hình khóa và điểm cuối API của bạn thông qua các biến môi trường — không cần thay đổi mã để tích hợp AnBoWork.

CẮM
Bạn muốn xây dựng plugin cho ứng dụng máy tính để bàn AnBoWork (thêm công cụ cho AI, gắn bảng điều khiển bên, gửi thông báo hệ thống)?Tài liệu dành cho nhà phát triển plugin

01Điểm cuối API

Anthropic SDK (Claude Code v.v.)
https://api.anbowork.com
OpenAI SDK / HTTP
https://api.anbowork.com/v1
KEY
Tạo khóa trong bảng điều khiển trong phần "Quản lý khóa API". Nó trông giống như sk-your-api-key. Chuyển nó trong các yêu cầu dưới dạng Ủy quyền: Bearer sk-...

02Biến môi trường

Windows Thiết lập

Chỉ có hiệu lực cho phiên cuối hiện tại. Đóng khi cửa sổ đóng lại. Tốt để thử nghiệm nhanh chóng.

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

macOS / Linux Thiết lập

Chỉ có hiệu lực cho phiên cuối hiện tại. Đóng khi cửa sổ đóng lại. Tốt để thử nghiệm nhanh chóng.

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

03Tích hợp công cụ

Các công cụ mã hóa AI chính thống có thể kết nối trực tiếp với AnBoWork — chỉ cần đặt các biến môi trường hoặc cấu hình bên dưới.

Claude Code CLI

CLI chính thức của Anthropic — kết nối với AnBoWork thông qua các biến môi trường, không cần thay đổi mã.

Đi tới Quản lý khóa API để tải xuống tập lệnh thiết lập bằng một cú nhấp chuột →
# bash / zsh (valid for current session only)
export ANTHROPIC_BASE_URL="https://api.anbowork.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

Sau đó khởi chạy với:

claude

Codex CLI

OpenAI chính thức Codex CLI - sử dụng điểm cuối /v1/responses. Lưu ý: base_url phải bao gồm /v1.

Chỉnh sửa ~/.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"

Sau đó đặt khóa API làm biến môi trường:

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

Sau đó khởi chạy với:

codex

Cursor / Lướt ván buồm

Ghi đè điểm cuối OpenAI và khóa API trong cài đặt.

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

Cline (Mã VS)

Chọn nhà cung cấp tương thích OpenAI trong Cline rồi nhập điểm cuối, khóa và tên kiểu máy.

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

04Ví dụ về mã

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)

Cài đặt: pip install anthropic / openai · npm install openai

05Truyền phát

Thêm luồng: true vào nội dung yêu cầu của bạn để bật phát trực tuyến SSE — lý tưởng cho giao diện người dùng trò chuyện theo thời gian thực.

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)

06Chuyển đổi định dạng tự động

AnBoWork thực hiện chuyển đổi hai chiều minh bạch giữa Anthropic Tin nhắn và OpenAI Trò chuyện ở cấp cổng. Điều này có nghĩa là bạn có thể gọi cùng một mô hình theo kiểu Anthropic hoặc kiểu OpenAI — một cơ sở mã, bất kỳ mô hình nào.

Ánh xạ trường chính giữa hai kiểu:

Anthropic Phong cáchOpenAI Phong cáchSự miêu tả
systemmessages[role=system]Dấu nhắc hệ thống được định vị khác nhau; cổng xử lý nó tự động
max_tokens(必填)max_tokens(可选)Khi bị bỏ qua, cổng sẽ áp dụng giới hạn mặc định của mô hình
content 分块数组content 字符串Khối văn bản/hình ảnh chuyển đổi sang và từ chuỗi
stop_reasonfinish_reasonHoàn tất việc ánh xạ tên trường lý do
TIP
Đã có mã OpenAI và muốn gọi cho Claude? Chỉ cần thay đổi base_url và model — không cần chạm vào cấu trúc thông báo.

07Đa phương thức

Việc tạo hình ảnh sử dụng cùng một cổng và khóa API, được tính phí theo mức sử dụng.

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

08Gọi hàm

Xác định các hàm có thể gọi bằng cách sử dụng các công cụ kiểu OpenAI. Mô hình trả về tool_calls khi cần và mã của bạn sẽ thực thi chúng và trả về kết quả.

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)

09Xử lý lỗi

/v1/* điểm cuối tuân theo định dạng lỗi của OpenAI — phản hồi chứa loại/mã/thông báo.

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

Mã lỗi phổ biến

HTTPSự miêu tả
401Khóa API không hợp lệ hoặc bị thiếu
402Số dư không đủ - vui lòng nạp tiền
429Tỷ lệ giới hạn hoặc hết hạn ngạch hàng ngày
503Tất cả các kênh ngược dòng đều không khả dụng (hỏng mạch)
Xem tất cả mẫu mã và giá cả →