// Quick Start

التوثيق

قم بتكوين نقطة نهاية واجهة برمجة التطبيقات (API) ومفتاحك عبر متغيرات البيئة - لا يلزم إجراء تغييرات على التعليمات البرمجية للدمج AnBoWork.

البرنامج المساعد
هل ترغب في إنشاء مكون إضافي لتطبيق سطح المكتب 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. قم بتمريرها في الطلبات كتفويض: Bearer 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تكامل الأداة

يمكن لأدوات ترميز الذكاء الاصطناعي السائدة الاتصال مباشرة بـ AnBoWork — ما عليك سوى تعيين متغيرات البيئة أو التكوين أدناه.

Claude Code كلي

واجهة سطر الأوامر الرسمية لـ Anthropic — اتصل بـ AnBoWork عبر متغيرات البيئة، دون الحاجة إلى تغييرات في التعليمات البرمجية.

انتقل إلى API Key Management لتنزيل البرنامج النصي للإعداد بنقرة واحدة →
# 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. يقوم النموذج بإرجاع استدعاءات الأداة عند الحاجة، ويقوم الكود الخاص بك بتنفيذها وإرجاع النتائج.

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جميع قنوات المنبع غير متاحة (الدائرة مكسورة)
شاهد جميع الموديلات والأسعار →