Mandrosoa any amin'ny votoaty
SDK

SDK

SDK OpenAI na Anthropic rehetra dia miasa avy hatrany.

Shannon dia miteny amin'ny endrika wire OpenAI sy Anthropic, ka azonao ampiasaina araka izy ny SDK ofisialy roa. Mamadika sanda telo ao amin'ny client ianao: ny base URL, ny API key ary ny id model. Ny sisa amin'ny kaody-nao dia tsy miova.

Izay apetraka

Setting SDK OpenAI SDK Anthropic
Base URL https://api.shannon-ai.com/v1 https://api.shannon-ai.com
API key Ny Shannon key-nao. Ny SDK dia mandefa azy ho Authorization: Bearer. Ny Shannon key-nao. Ny SDK dia mandefa azy ho x-api-key.
Model Id model navoaka, ohatra shannon-3. Id model navoaka, ohatra shannon-1.6-lite.
Endpoint azony /v1/chat/completions, /v1/responses, /v1/models /v1/messages, /v1/messages/count_tokens
Environment variable OPENAI_API_KEY sy OPENAI_BASE_URL, vakian'ny SDK Python sy JavaScript rehefa tsy mandefa sanda ianao. ANTHROPIC_API_KEY sy ANTHROPIC_BASE_URL, vakian'ny SDK Python sy TypeScript rehefa tsy mandefa sanda ianao.

Ny base URL roa dia tsy mitovy amin'ny /v1: ny SDK OpenAI dia manampy /chat/completions amin'ny base URL-ny, ny SDK Anthropic kosa manampy /v1/messages. Ny anaran'ny model tsy navoakan'i Shannon dia valiana amin'ny 400 sy unknown model. Model & vidiny

Ny key-nao dia ao amin'ny pejy Keys & usage. Keys & usage

SDK OpenAI

Ny SDK OpenAI ofisialy dia miantso ny POST /v1/chat/completions sy POST /v1/responses. Ny ohatra tsirairay dia mandefa hafatry ny mpampiasa iray ary manonta ny valiny.

# 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)
Fiteny Fametrahana Safidy base URL Source
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

Ny saha rehetra amin'ny endpoint roa dia voasoratra ao amin'ny pejiny manokana. Chat Completions Responses API

SDK Anthropic

Ny SDK Anthropic ofisialy dia miantso ny POST /v1/messages. Mitaky max_tokens isaky ny antso izy ireo, ka ny ohatra dia mampiasa shannon-1.6-lite, izay mampihatra azy. Ny ohatra tsirairay dia manonta ny text block amin'ny valiny.

# 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)
Fiteny Fametrahana Safidy base URL Source
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

Ny endrika Messages sy ny tsy fitoviany dia ao amin'ny pejy Anthropic compatibility. Anthropic

Izay azon'ny SDK iankinana

  • Ny saha fangatahana tsy ampiasain'ny API dia raisina. Ny saha fantatry ny API, alefa amin'ny karazana diso, dia valiana amin'ny 422.
  • Ny header version sy beta ampiana ny SDK (anthropic-version, anthropic-beta, openai-beta) dia raisina. Tsy ilaina na iray aza.
  • Ny model an'ny valiny dia ny id navoaka, ka azonao averina alefa araka izy.
  • Amin'ny /v1/messages, ny valiny dia mety manomboka amin'ny block thinking. Vakio ny block karazana text fa aza raisina ny block voalohany.
  • Mandeha amin'ny stream helper an'ny SDK ny streaming. Tonga amin'ny faran'ny stream rehetra ny usage.
  • Ny valiny rehetra dia mitondra header x-request-id. Alefaso ny x-request-id anao ary miverina ny sanda mitovy.

SDK avy amin'ny vondrom-piarahamonina

Ny client nosoratan'ny mpanoratra hafa ho an'ny API OpenAI dia mandeha mitovy: omeo ny client ny base URL miaraka amin'ny /v1, ny key-nao ary id model Shannon. Ireo dia tantanan'ny mpanoratra azy, fa tsy an'i Shannon.

Fiteny Fametrahana Client
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

Tsy misy SDK

Tsy mila SDK ianao. Client HTTP rehetra afaka mandefa JSON dia mandeha:

  • POST miaraka amin'ny body JSON sy ny header Content-Type: application/json. Raha tsy misy dia valiana amin'ny 415 ny fangatahana.
  • Ny key-nao ao amin'ny Authorization: Bearer <key> na ao amin'ny x-api-key: <key>. Samy mandeha amin'ny endpoint rehetra.
  • Body hatramin'ny 32 MiB.
  • Miaraka amin'ny "stream": true ny valiny dia stream server-sent event (text/event-stream). Vakio andalana isan-andalana ary aza buffer-ina.
  • Ny hadisoana dia body JSON misy error.type sy error.message, eo anilan'ny 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!"}]
  }'

Ho an'ny event ao anaty stream sy ny karazana hadisoana, jereo: Fandefasana mivantana Fitantanana hadisoana