Kalo te përmbajtja
SDK

SDK

Çdo SDK e OpenAI ose Anthropic funksionon menjëherë.

Shannon flet format e linjës OpenAI dhe Anthropic, prandaj i përdorni SDK-të zyrtare të të dyjave siç janë. Ndryshoni tri vlera te klienti: URL-në bazë, çelësin API dhe id-në e modelit. Pjesa tjetër e kodit tuaj mbetet e njëjtë.

Çfarë të caktoni

Cilësimi SDK-të OpenAI SDK-të Anthropic
URL bazë https://api.shannon-ai.com/v1 https://api.shannon-ai.com
Çelësi API Çelësi juaj Shannon. SDK-ja e dërgon si Authorization: Bearer. Çelësi juaj Shannon. SDK-ja e dërgon si x-api-key.
Modeli Një id modeli e publikuar, për shembull shannon-3. Një id modeli e publikuar, për shembull shannon-1.6-lite.
Endpoint-et që arrin /v1/chat/completions, /v1/responses, /v1/models /v1/messages, /v1/messages/count_tokens
Variablat e mjedisit OPENAI_API_KEY dhe OPENAI_BASE_URL, të lexuara nga SDK-të Python dhe JavaScript kur nuk jepni vlerë. ANTHROPIC_API_KEY dhe ANTHROPIC_BASE_URL, të lexuara nga SDK-të Python dhe TypeScript kur nuk jepni vlerë.

Dy URL-të bazë ndryshojnë me /v1: një SDK OpenAI shton /chat/completions te URL-ja e vet bazë, një SDK Anthropic shton /v1/messages. Një emër modeli që Shannon nuk e publikon merr përgjigje 400 dhe unknown model. Modelet dhe çmimet

Çelësi juaj është në faqen Çelësat dhe përdorimi. Çelësat dhe përdorimi

SDK-të OpenAI

SDK-të zyrtare OpenAI thërrasin POST /v1/chat/completions dhe POST /v1/responses. Çdo shembull dërgon një mesazh përdoruesi dhe printon përgjigjen.

# 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)
Gjuha Instalimi Opsioni i URL-së bazë Burimi
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

Çdo fushë e dy endpoint-eve përshkruhet në faqet e tyre. Chat Completions Responses API

SDK-të Anthropic

SDK-të zyrtare Anthropic thërrasin POST /v1/messages. Ato kërkojnë max_tokens në çdo thirrje, prandaj shembujt përdorin shannon-1.6-lite, që e zbaton. Çdo shembull printon blloqet e tekstit të përgjigjes.

# 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)
Gjuha Instalimi Opsioni i URL-së bazë Burimi
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

Formati Messages dhe dallimet e tij janë në faqen e pajtueshmërisë me Anthropic. Formati Anthropic

Çfarë mund të mbështesin SDK-të

  • Një fushë kërkese që API-ja nuk e përdor pranohet. Një fushë që API-ja e njeh, e dërguar me lloj të gabuar, merr përgjigje 422.
  • Header-at e versionit dhe beta që shtojnë SDK-të (anthropic-version, anthropic-beta, openai-beta) pranohen. Asnjëri nuk kërkohet.
  • model i një përgjigjeje është id-ja e publikuar, kështu që mund ta dërgoni mbrapsht siç është.
  • Në /v1/messages një përgjigje mund të fillojë me një bllok thinking. Lexoni blloqet e llojit text në vend që të merrni blokun e parë.
  • Streaming funksionon përmes ndihmësve të stream-it të vetë SDK-së. Përdorimi arrin në fund të çdo stream-i.
  • Çdo përgjigje mban një header x-request-id. Dërgoni x-request-id tuaj dhe kthehet e njëjta vlerë.

SDK-të e komunitetit

Klientët e shkruar për API-n OpenAI nga autorë të tjerë funksionojnë njësoj: jepini klientit URL-në bazë me /v1, çelësin tuaj dhe një id modeli Shannon. Këta mirëmbahen nga autorët e tyre, jo nga Shannon.

Gjuha Instalimi Klienti
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

Pa SDK

Nuk keni nevojë për SDK. Funksionon çdo klient HTTP që mund të dërgojë JSON:

  • POST me trup JSON dhe header-in Content-Type: application/json. Pa të kërkesa merr përgjigje 415.
  • Çelësi juaj te Authorization: Bearer <key> ose te x-api-key: <key>. Të dyja funksionojnë në çdo endpoint.
  • Një trup deri në 32 MiB.
  • Me "stream": true përgjigjja është një stream server-sent events (text/event-stream). Lexojeni rresht pas rreshti dhe mos e ruani në buffer.
  • Një gabim është një trup JSON me error.type dhe error.message, pranë statusit 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!"}]
  }'

Për ngjarjet e një stream-i dhe llojet e gabimeve, shihni: Transmetim Trajtimi i gabimeve