بازدان بۆ ناوەڕۆک
SDK

SDK

هەر SDK ێکی OpenAI یان Anthropic بێ ڕێکخستنی زیادە کار دەکات.

Shannon فۆرماتەکانی تۆڕی OpenAI و Anthropic بەکاردەهێنێت، بۆیە SDK ـە فەرمییەکانی هەردووکیان وەک خۆیان بەکاردەهێنیت. سێ بەها لە کلاینتەکەدا دەگۆڕیت: base URL، کلیلی API و id ی مۆدێل. ماوەی کۆدەکەت وەک خۆی دەمێنێتەوە.

چی دابنرێت

ڕێکخستن SDK ـەکانی OpenAI SDK ـەکانی Anthropic
Base 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، لەلایەن SDK ـەکانی Python و JavaScript ەوە دەخوێنرێنەوە کاتێک هیچ بەهایەک نادەیت. ANTHROPIC_API_KEY و ANTHROPIC_BASE_URL، لەلایەن SDK ـەکانی Python و TypeScript ەوە دەخوێنرێنەوە کاتێک هیچ بەهایەک نادەیت.

ئەو دوو base URL ـە بە /v1 جیاوازن: SDK ی OpenAI /chat/completions دەخاتە سەر base URL ـەکەی، SDK ی Anthropic /v1/messages زیاد دەکات. ناوی مۆدێلێک کە Shannon بڵاوی نەکردبێتەوە بە 400 و unknown model وەڵام دەدرێتەوە. مۆدێل و نرخ

کلیلەکەت لە لاپەڕەی Keys & usage دایە. Keys & usage

SDK ـەکانی OpenAI

SDK ـە فەرمییەکانی OpenAI 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)
زمان دامەزراندن بژاردەی Base 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

SDK ـەکانی Anthropic

SDK ـە فەرمییەکانی Anthropic POST /v1/messages بانگ دەکەن. max_tokens لەسەر هەر بانگکردنێک پێویستە، بۆیە نموونەکان shannon-1.6-lite بەکاردەهێنن، کە جێبەجێی دەکات. هەر نموونەیەک بلۆکەکانی دەقی وەڵامەکە چاپ دەکات.

# 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)
زمان دامەزراندن بژاردەی Base 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 دان. Anthropic

ئەوەی SDK ـەکان دەتوانن پشتی پێ ببەستن

  • بوارێکی داواکاری کە API بەکاری ناهێنێت وەردەگیرێت. بوارێک کە API دەیناسێت، بە جۆری هەڵە نێردرابێت، بە 422 وەڵام دەدرێتەوە.
  • headers ی وەشان و beta کە SDK ـەکان زیادیان دەکەن (anthropic-version، anthropic-beta، openai-beta) وەردەگیرێن. هیچیان پێویست نین.
  • model ی وەڵامێک id ی بڵاوکراوە، بۆیە دەتوانیت وەک خۆی بیگەڕێنیتەوە.
  • لەسەر /v1/messages وەڵامێک دەکرێت بە بلۆکی thinking دەست پێبکات. بلۆکەکانی جۆری text بخوێنەرەوە لەبری ئەوەی یەکەم بلۆک وەربگریت.
  • Streaming لە ڕێگەی helper ـەکانی stream ی خودی SDK ـەوە کار دەکات. Usage لە کۆتایی هەر stream ێکدا دەگات.
  • هەر وەڵامێک header ی x-request-id هەڵدەگرێت. x-request-id ی خۆت بنێرە و هەمان بەها دەگەڕێتەوە.

SDK ـەکانی کۆمەڵگە

ئەو کلاینتانەی نووسەرانی دیکە بۆ API ی OpenAI نووسیویانن بە هەمان شێوە کار دەکەن: base URL لەگەڵ /v1، کلیلەکەت و id ی مۆدێلێکی Shannon بدە بە کلاینتەکە. ئەمانە لەلایەن نووسەرەکانیانەوە بەڕێوە دەبرێن، نەک لەلایەن 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 نییە. هەر کلاینتێکی HTTP کە بتوانێت JSON بنێرێت کار دەکات:

  • POST لەگەڵ body ی JSON و header ی Content-Type: application/json. بەبێ ئەوە داواکارییەکە بە 415 وەڵام دەدرێتەوە.
  • کلیلەکەت لە Authorization: Bearer <key> یان لە x-api-key: <key>. هەردووکیان لەسەر هەموو endpoint ێک کار دەکەن.
  • body ێک تا 32 MiB.
  • لەگەڵ "stream": true وەڵامەکە stream ی server-sent event ە (text/event-stream). هێڵ بە هێڵ بیخوێنەرەوە و buffer ی مەکە.
  • هەڵە body ێکی JSON ە بە error.type و error.message، لەتەنیشت status ی HTTP.
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 و جۆرەکانی هەڵە، ببینە: Streaming Çewtî