Агуулга руу алгасах
SDK-ууд

SDK-ууд

OpenAI эсвэл Anthropic-ийн аль ч SDK нэмэлт тохиргоогүй ажиллана.

Shannon нь OpenAI болон Anthropic-ийн wire форматаар ярьдаг тул хоёулангийнх нь албан ёсны SDK-г хэвээр нь ашиглана. Клиентэд гурван утга солино: үндсэн URL, API түлхүүр, загварын id. Кодын бусад хэсэг хэвээр үлдэнэ.

Юуг тохируулах

Тохиргоо OpenAI SDK-ууд Anthropic SDK-ууд
Үндсэн URL https://api.shannon-ai.com/v1 https://api.shannon-ai.com
API түлхүүр Таны Shannon түлхүүр. SDK үүнийг Authorization: Bearer болгон илгээнэ. Таны Shannon түлхүүр. SDK үүнийг x-api-key болгон илгээнэ.
Загвар Нийтэлсэн загварын id, жишээлбэл shannon-3. Нийтэлсэн загварын id, жишээлбэл shannon-1.6-lite.
Хүрдэг endpoint-ууд /v1/chat/completions, /v1/responses, /v1/models /v1/messages, /v1/messages/count_tokens
Орчны хувьсагчид OPENAI_API_KEY ба OPENAI_BASE_URL, утга дамжуулаагүй үед Python ба JavaScript SDK-ууд уншина. ANTHROPIC_API_KEY ба ANTHROPIC_BASE_URL, утга дамжуулаагүй үед Python ба TypeScript SDK-ууд уншина.

Хоёр үндсэн URL /v1-ээр ялгаатай: OpenAI SDK үндсэн URL-даа /chat/completions нэмдэг, Anthropic SDK /v1/messages нэмдэг. Shannon-ий нийтлээгүй загварын нэрэнд 400 ба unknown model-оор хариулна. Загвар ба үнэ

Таны түлхүүр Keys & usage хуудсанд байна. Түлхүүр ба хэрэглээ

OpenAI SDK-ууд

Албан ёсны OpenAI SDK-ууд POST /v1/chat/completions ба POST /v1/responses-ийг дууддаг. Жишээ бүр нэг хэрэглэгчийн мессеж илгээж, хариултыг хэвлэнэ.

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com/v1",
)

response = client.chat.completions.create(
    model="shannon-3",
    messages=[{"role": "user", "content": "Hello, Shannon!"}],
)
print(response.choices[0].message.content)
Хэл Суулгах Үндсэн URL-ийн сонголт Эх сурвалж
Python pip install openai base_url openai/openai-python
JavaScript / TypeScript npm install openai baseURL openai/openai-node
Go go get github.com/openai/openai-go/v3 option.WithBaseURL openai/openai-go
Java com.openai:openai-java baseUrl openai/openai-java
.NET dotnet add package OpenAI OpenAIClientOptions.Endpoint openai/openai-dotnet

Хоёр endpoint-ийн талбар бүрийг тэдний өөрийн хуудсанд тайлбарласан. Chat Completions Responses API

Anthropic SDK-ууд

Албан ёсны Anthropic SDK-ууд POST /v1/messages-ийг дууддаг. Дуудлага бүрт max_tokens шаарддаг тул жишээнүүд үүнийг хэрэгжүүлдэг shannon-1.6-lite-ийг ашигладаг. Жишээ бүр хариултын text block-уудыг хэвлэнэ.

# pip install anthropic
import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com",
)

message = client.messages.create(
    model="shannon-1.6-lite",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Shannon!"}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)
Хэл Суулгах Үндсэн URL-ийн сонголт Эх сурвалж
Python pip install anthropic base_url anthropics/anthropic-sdk-python
TypeScript npm install @anthropic-ai/sdk baseURL anthropics/anthropic-sdk-typescript
Go go get github.com/anthropics/anthropic-sdk-go option.WithBaseURL anthropics/anthropic-sdk-go
Java com.anthropic:anthropic-java baseUrl anthropics/anthropic-sdk-java

Messages формат ба түүний ялгааг Anthropic compatibility хуудсанд тайлбарласан. Anthropic

SDK-ууд юунд найдаж болох вэ

  • API-ийн ашигладаггүй хүсэлтийн талбарыг хүлээн авна. API-ийн мэддэг талбарыг буруу төрлөөр илгээвэл 422-оор хариулна.
  • SDK-уудын нэмдэг version ба beta header-үүдийг (anthropic-version, anthropic-beta, openai-beta) хүлээн авна. Аль нь ч заавал биш.
  • Хариуны model нь нийтэлсэн id тул түүнийг хэвээр нь буцааж илгээж болно.
  • /v1/messages дээр хариу thinking block-оор эхэлж болно. Эхний block-ийг авахын оронд text төрлийн block-уудыг уншина уу.
  • Streaming нь SDK-ийн өөрийн stream туслахуудаар ажиллана. Usage нь stream бүрийн төгсгөлд ирнэ.
  • Хариу бүр x-request-id header-тэй. Өөрийн x-request-id-г илгээвэл ижил утга буцаж ирнэ.

Community SDK-ууд

Бусад зохиогчдын OpenAI API-д зориулж бичсэн клиентүүд адилхан ажиллана: клиентэд /v1-тэй үндсэн URL, түлхүүр, Shannon загварын id өгнө. Эдгээрийг Shannon биш, зохиогчид нь хөтөлдөг.

Хэл Суулгах Клиент
Go go get github.com/sashabaranov/go-openai sashabaranov/go-openai
Ruby gem install ruby-openai alexrudall/ruby-openai
PHP composer require openai-php/client openai-php/client
Rust cargo add async-openai 64bit/async-openai

SDK-гүйгээр

SDK шаардлагагүй. JSON илгээж чадах дурын HTTP клиент ажиллана:

  • JSON body ба Content-Type: application/json header-тэй POST. Түүнгүй бол хүсэлтэд 415-аар хариулна.
  • Таны түлхүүр Authorization: Bearer <key> эсвэл x-api-key: <key> дотор. Хоёулаа endpoint бүр дээр ажиллана.
  • 32 MiB хүртэлх body.
  • "stream": true-тэй үед хариу нь server-sent event stream (text/event-stream). Мөр мөрөөр нь уншиж, buffer хийхгүй.
  • Алдаа нь HTTP статусын хажууд error.type ба error.message-тэй JSON body.
curl https://api.shannon-ai.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-3",
    "messages": [{"role": "user", "content": "Hello, Shannon!"}]
  }'

Stream-ийн event болон алдааны төрлийг дараахаас үзнэ үү: Дамжуулалт Алдаа боловсруулах