// Quick Start

مستندات

نقطه پایانی و کلید API خود را از طریق متغیرهای محیطی پیکربندی کنید — برای ادغام AnBoWork نیازی به تغییر کد نیست.

PLUGIN
آیا می خواهید یک افزونه برای برنامه دسکتاپ AnBoWork بسازید (ابزارهایی برای هوش مصنوعی اضافه کنید، پانل کناری را نصب کنید، اعلان های سیستم را ارسال کنید)؟اسناد توسعه دهنده پلاگین

01نقاط پایانی API

Anthropic SDK (Claude Code و غیره)
https://api.anbowork.com
OpenAI SDK / HTTP
https://api.anbowork.com/v1
KEY
یک کلید در کنسول زیر "API Key Management" ایجاد کنید. به نظر می رسد sk-your-api-key. آن را در درخواست ها به عنوان مجوز ارسال کنید: حامل sk-...

02متغیرهای محیطی

Windows راه اندازی

فقط برای جلسه ترمینال فعلی معتبر است. با بسته شدن پنجره بسته می شود. برای تست سریع خوبه

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

macOS / Linux راه اندازی

فقط برای جلسه ترمینال فعلی معتبر است. با بسته شدن پنجره بسته می شود. برای تست سریع خوبه

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

03یکپارچه سازی ابزار

ابزارهای کدگذاری AI اصلی می توانند مستقیماً به AnBoWork متصل شوند - کافیست متغیرهای محیط یا پیکربندی را در زیر تنظیم کنید.

Claude Code CLI

CLI رسمی Anthropic — از طریق متغیرهای محیطی به AnBoWork متصل شوید، بدون نیاز به تغییر کد.

برای دانلود یک اسکریپت راه اندازی با یک کلیک → به مدیریت کلید API بروید
# bash / zsh (valid for current session only)
export ANTHROPIC_BASE_URL="https://api.anbowork.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

سپس راه اندازی کنید با:

claude

Codex CLI

رسمی OpenAI Codex CLI — از نقطه پایانی /v1/responses استفاده می کند. توجه: base_url باید شامل /v1 باشد.

ویرایش ~/.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"

سپس کلید API را به عنوان یک متغیر محیطی تنظیم کنید:

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

سپس راه اندازی کنید با:

codex

Cursor / موج سواری

نقطه پایانی OpenAI و کلید API را در تنظیمات لغو کنید.

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

Cline (کد VS)

ارائه دهنده سازگار OpenAI را در Cline انتخاب کنید و نقطه پایان، کلید و نام مدل را وارد کنید.

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

04نمونه های کد

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)

نصب کنید: pip install anthropic / openai · npm install openai

05پخش جریانی

اضافه کردن جریان: برای فعال کردن پخش جریانی SSE، مطابق با بدنه درخواست شما - ایده‌آل برای رابط‌های کاربری چت هم‌زمان.

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)

06تبدیل خودکار فرمت

AnBoWork تبدیل شفاف دو طرفه بین Anthropic پیام ها و OpenAI چت را در سطح دروازه انجام می دهد. این به این معنی است که می‌توانید همان مدل را به سبک Anthropic یا سبک OpenAI فراخوانی کنید - یک پایگاه کد، هر مدلی.

نگاشت میدان کلیدی بین دو سبک:

Anthropic سبکOpenAI سبکتوضیحات
systemmessages[role=system]اعلان سیستم به طور متفاوتی قرار می گیرد. دروازه به طور خودکار آن را کنترل می کند
max_tokens(必填)max_tokens(可选)در صورت حذف، دروازه محدودیت پیش فرض مدل را اعمال می کند
content 分块数组content 字符串بلوک های متن/تصویر به رشته ها و از رشته ها تبدیل می شوند
stop_reasonfinish_reasonنگاشت نام فیلد دلیل را تمام کنید
TIP
قبلاً کد OpenAI دارید و می‌خواهید با کلود تماس بگیرید؟ فقط base_url و مدل را تغییر دهید - نیازی به لمس ساختار پیام نیست.

07چند وجهی

تولید تصویر از همان دروازه و کلید API استفاده می‌کند که براساس استفاده صورت‌حساب می‌شود.

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

08فراخوانی تابع

توابع قابل فراخوانی را با استفاده از ابزارهای سبک OpenAI تعریف کنید. مدل در صورت نیاز tool_calls را برمی‌گرداند و کد شما آنها را اجرا کرده و نتایج را برمی‌گرداند.

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)

09رسیدگی به خطا

نقاط پایانی /v1/* از فرمت خطای OpenAI پیروی می کنند - پاسخ ها حاوی نوع / کد / پیام هستند.

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

کدهای خطای رایج

HTTPتوضیحات
401کلید API نامعتبر است یا وجود ندارد
402موجودی کافی نیست - لطفا شارژ کنید
429محدود یا سهمیه روزانه تمام شده است
503همه کانال‌های بالادست در دسترس نیستند (مدار خراب است)
مشاهده همه مدل ها و قیمت →