// Quick Start

Dokumentacja

Skonfiguruj punkt końcowy i klucz API za pomocą zmiennych środowiskowych — do integracji AnBoWork nie są potrzebne żadne zmiany w kodzie.

WTYCZKA

Chcesz zbudować wtyczkę do aplikacji komputerowej AnBoWork (dodać narzędzia dla AI, zadokować panel boczny, wysłać powiadomienia systemowe)?Dokumentacja programisty wtyczek

01Punkty końcowe interfejsu API

Anthropic SDK (Claude Code itd.)

https://api.anbowork.com

OpenAI SDK / HTTP

https://api.anbowork.com/v1

KEY

Utwórz klucz w konsoli w sekcji „Zarządzanie kluczami API”. Wygląda jak sk-your-api-key. Przekaż go w żądaniach jako Autoryzacja: Bearer sk-...

02Zmienne środowiskowe

Windows Konfiguracja

Obowiązuje tylko dla bieżącej sesji terminala. Zamyka się, gdy zamyka się okno. Dobry do szybkiego testowania.

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

macOS / Linux Konfiguracja

Obowiązuje tylko dla bieżącej sesji terminala. Zamyka się, gdy zamyka się okno. Dobry do szybkiego testowania.

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

03Integracja narzędzi

Narzędzia do kodowania AI głównego nurtu mogą łączyć się bezpośrednio z AnBoWork — wystarczy ustawić zmienne środowiskowe lub konfigurację poniżej.

Claude Code Interfejs wiersza polecenia

Oficjalne CLI Anthropic — połącz się z AnBoWork poprzez zmienne środowiskowe, nie są potrzebne żadne zmiany w kodzie.

Przejdź do API Key Management, aby pobrać skrypt instalacyjny jednym kliknięciem →

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

Następnie uruchom za pomocą:

claude

Codex CLI

Oficjalny OpenAI Codex CLI — używa punktu końcowego /v1/respons. Uwaga: base_url musi zawierać /v1.

Edytuj ~/.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"

Następnie ustaw klucz API jako zmienną środowiskową:

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

Następnie uruchom za pomocą:

codex

Cursor / Windsurfing

Zastąp punkt końcowy OpenAI i klucz API w ustawieniach.

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

Cline (kod VS)

Wybierz OpenAI Zgodnego dostawcę w Cline i wprowadź punkt końcowy, klucz i nazwę modelu.

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

04Przykłady kodu

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)

Zainstalować: pip install anthropic / openai · npm install openai

05Transmisja strumieniowa

Dodaj strumień: zgodny z treścią żądania, aby umożliwić przesyłanie strumieniowe SSE — idealne rozwiązanie w przypadku interfejsów czatu w czasie rzeczywistym.

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)

06Automatyczna konwersja formatu

AnBoWork wykonuje przezroczystą dwukierunkową konwersję pomiędzy Anthropic Wiadomościami i OpenAI Czatem na poziomie bramy. Oznacza to, że możesz wywołać ten sam model w stylu Anthropic lub OpenAI — jedna baza kodu, dowolny model.

Kluczowe mapowania pól pomiędzy dwoma stylami:

Anthropic Styl	OpenAI Styl	Opis
system	messages[role=system]	Podpowiedź systemowa jest umiejscowiona inaczej; brama obsługuje to automatycznie
max_tokens（必填）	max_tokens（可选）	W przypadku pominięcia brama stosuje domyślny limit modelu
content 分块数组	content 字符串	Bloki tekstu/obrazu konwertują na ciągi znaków i z nich
stop_reason	finish_reason	Zakończ mapowanie nazwy pola przyczyny

TIP

Masz już kod OpenAI i chcesz zadzwonić do Claude'a? Po prostu zmień base_url i model — nie musisz dotykać struktury wiadomości.

07Multimodalny

Generowanie obrazów korzysta z tej samej bramy i klucza API, a opłaty są naliczane według użycia.

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

08Wywołanie funkcji

Zdefiniuj funkcje wywoływalne za pomocą narzędzi w stylu OpenAI. Model w razie potrzeby zwraca wywołania narzędzi, a kod je wykonuje i zwraca wyniki.

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)

09Obsługa błędów

Punkty końcowe /v1/* mają format błędu OpenAI — odpowiedzi zawierają typ/kod/komunikat.

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

Typowe kody błędów

HTTP	Opis
401	Klucz API jest nieprawidłowy lub go brakuje
402	Niewystarczające saldo — proszę doładować
429	Stawka ograniczona lub wyczerpany limit dzienny
503	Wszystkie kanały nadrzędne niedostępne (przerwany obwód)

Zobacz wszystkie modele i ceny →