// Quick Start

תיעוד

הגדר את נקודת הקצה והמפתח של ה-API שלך באמצעות משתני סביבה - אין צורך בשינויי קוד כדי לשלב AnBoWork.

PLUGIN
רוצה לבנות תוסף עבור אפליקציית שולחן העבודה AnBoWork (הוסף כלים עבור AI, עגינה פאנל צדדי, שלח הודעות מערכת)?מסמכי מפתח של תוסף

01נקודות קצה של API

Anthropic SDK (Claude Code וכו')
https://api.anbowork.com
OpenAI SDK / HTTP
https://api.anbowork.com/v1
KEY
צור מפתח במסוף תחת "ניהול מפתחות API". זה נראה כמו sk-your-api-key. העבר את זה בבקשות כהרשאה: נושאת סק-...

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כל הערוצים במעלה הזרם אינם זמינים (המעגל נשבר)
ראה את כל הדגמים והתמחור →