Leum gun t-susbaint
SDKan

SDKan

Obraichidh SDK OpenAI no Anthropic sam bith gun atharrachadh.

Tha Shannon a’ bruidhinn cruthan uèir OpenAI agus Anthropic, agus mar sin cleachdaidh tu SDKan oifigeil an dà chuid mar a tha iad. Atharraichidh tu trì luachan sa client: am base URL, an iuchair API agus id a’ mhodail. Tha an còrr dhe do chòd mar a bha.

Na bu chòir a shuidheachadh

Roghainn OpenAI SDKan Anthropic SDKan
Base URL https://api.shannon-ai.com/v1 https://api.shannon-ai.com
Iuchair API D’ iuchair Shannon. Cuiridh an SDK i mar Authorization: Bearer. D’ iuchair Shannon. Cuiridh an SDK i mar x-api-key.
Modail Id modail foillsichte, mar eisimpleir shannon-3. Id modail foillsichte, mar eisimpleir shannon-1.6-lite.
Endpoints a ruigeas e /v1/chat/completions, /v1/responses, /v1/models /v1/messages, /v1/messages/count_tokens
Caochladairean àrainneachd OPENAI_API_KEY agus OPENAI_BASE_URL, air an leughadh le SDKan Python agus JavaScript nuair nach cuir thu luach. ANTHROPIC_API_KEY agus ANTHROPIC_BASE_URL, air an leughadh le SDKan Python agus TypeScript nuair nach cuir thu luach.

Tha an dà base URL eadar-dhealaichte le /v1: cuiridh OpenAI SDK /chat/completions ris a base URL, cuiridh Anthropic SDK /v1/messages. Thèid ainm modail nach foillsich Shannon a fhreagairt le 400 agus unknown model. Modailean & prìsean

Tha d’ iuchair air an duilleag Keys & usage. Iuchraichean & cleachdadh

OpenAI SDKan

Gairmidh na OpenAI SDKan oifigeil POST /v1/chat/completions agus POST /v1/responses. Cuiridh gach sampall aon teachdaireachd neach-cleachdaidh agus clò-bhuailidh e am freagairt.

# 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)
Cànan Stàlaich Roghainn base URL Tùs
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

Tha gach raon dhen dà endpoint air am mìneachadh air na duilleagan aca fhèin. Chat Completions Responses API

Anthropic SDKan

Gairmidh na Anthropic SDKan oifigeil POST /v1/messages. Feumaidh iad max_tokens air gach gairm, agus mar sin cleachdaidh na sampaill shannon-1.6-lite, a chuireas e an gnìomh. Clò-bhuailidh gach sampall blocaichean teacsa an fhreagairt.

# 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)
Cànan Stàlaich Roghainn base URL Tùs
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

Tha cruth Messages agus na h-eadar-dhealachaidhean aige air an duilleag co-chòrdalachd Anthropic. Cruth anthropic

Na dh’fhaodas na SDKan earbsa a chur ann

  • Thèid raon iarrtais nach cleachd an API a ghabhail. Thèid raon a tha aithnichte dhan API, air a chur leis an t-seòrsa cheàrr, a fhreagairt le 422.
  • Thèid na headers tionndaidh is beta a chuireas na SDKan ris (anthropic-version, anthropic-beta, openai-beta) a ghabhail. Chan eil gin dhiubh riatanach.
  • Is e an id foillsichte model freagairt, agus mar sin faodaidh tu a chur air ais mar a tha e.
  • Air /v1/messages faodaidh freagairt tòiseachadh le bloc thinking. Leugh na blocaichean de sheòrsa text an àite a’ chiad bhloc a ghabhail.
  • Obraichidh streaming tro helpers stream an SDK fhèin. Thig usage aig deireadh gach stream.
  • Tha header x-request-id air gach freagairt. Cuir do x-request-id fhèin agus thig an aon luach air ais.

SDKan coimhearsnachd

Obraichidh clients a sgrìobh ùghdaran eile airson an OpenAI API san aon dòigh: thoir dhan client am base URL le /v1, d’ iuchair agus id modail Shannon. Tha iad sin air an cumail suas le an ùghdaran, chan ann le Shannon.

Cànan Stàlaich 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

Às aonais SDK

Chan eil feum agad air SDK. Obraichidh client HTTP sam bith as urrainn JSON a chur:

  • POST le bodhaig JSON agus an header Content-Type: application/json. Às aonais thèid an t-iarrtas a fhreagairt le 415.
  • D’ iuchair ann an Authorization: Bearer <key> no ann an x-api-key: <key>. Obraichidh an dà chuid air gach endpoint.
  • Bodhaig suas gu 32 MiB.
  • Le "stream": true is e stream server-sent event (text/event-stream) am freagairt. Leugh loidhne air loidhne e agus na dèan buffer air.
  • Is e bodhaig JSON le error.type agus error.message a th’ ann am mearachd, ri taobh staid 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!"}]
  }'

Airson tachartasan stream agus seòrsaichean mearachd, faic: Sruthadh Làimhseachadh mearachd