Peke ki ngā ihirangi
SDK

SDK

Ka mahi tonu ngā SDK OpenAI, Anthropic rānei.

Ka kōrero a Shannon i ngā hōputu waea OpenAI me Anthropic, nō reira ka whakamahi koe i ngā SDK ōkawa o ngā mea e rua pēnei i a rātou. Ka huri koe i ngā uara e toru i te kiritaki: te base URL, te API key me te id model. Ka noho tonu te toenga o tō waehere.

Ngā mea hei tautuhi

Tautuhinga Ngā SDK OpenAI Ngā SDK Anthropic
Base URL https://api.shannon-ai.com/v1 https://api.shannon-ai.com
API key Tō key Shannon. Ka tukuna e te SDK hei Authorization: Bearer. Tō key Shannon. Ka tukuna e te SDK hei x-api-key.
Model He id model kua whakaputaina, hei tauira shannon-3. He id model kua whakaputaina, hei tauira shannon-1.6-lite.
Ngā endpoint ka tae atu ia /v1/chat/completions, /v1/responses, /v1/models /v1/messages, /v1/messages/count_tokens
Ngā taurangi taiao OPENAI_API_KEY me OPENAI_BASE_URL, ka pānuitia e ngā SDK Python me JavaScript ina kāore koe e tuku uara. ANTHROPIC_API_KEY me ANTHROPIC_BASE_URL, ka pānuitia e ngā SDK Python me TypeScript ina kāore koe e tuku uara.

He rerekē ngā base URL e rua mā te /v1: ka tāpiri tētahi SDK OpenAI i te /chat/completions ki tōna base URL, ka tāpiri tētahi SDK Anthropic i te /v1/messages. Ka whakautua tētahi ingoa model kāore a Shannon e whakaputa ki te 400 me te unknown model. Ngā model me ngā utu

Kei te whārangi Keys & usage tō key. Keys & usage

Ngā SDK OpenAI

Ka karanga ngā SDK OpenAI ōkawa i te POST /v1/chat/completions me te POST /v1/responses. Ka tuku ia tauira i tētahi karere kaiwhakamahi, ā, ka tāngia te whakautu.

# 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)
Reo Whakaurunga Kōwhiringa base URL Pūtake
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

Kua whakaahuatia ia āpure o ngā endpoint e rua i ō rāua ake whārangi. Chat Completions Responses API

Ngā SDK Anthropic

Ka karanga ngā SDK Anthropic ōkawa i te POST /v1/messages. E hiahiatia ana e rātou te max_tokens i ia karanga, nō reira ka whakamahi ngā tauira i te shannon-1.6-lite, e whakamahi ana i a ia. Ka tāngia e ia tauira ngā poraka kuputuhi o te whakautu.

# 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)
Reo Whakaurunga Kōwhiringa base URL Pūtake
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

Kei te whārangi hototahi Anthropic te hōputu Messages me ōna rerekētanga. Anthropic

Ngā mea e taea e ngā SDK te whakawhirinaki

  • E whakaaetia ana tētahi āpure tono kāore e whakamahia e te API. Ka whakautua tētahi āpure e mōhiotia ana e te API, i tukuna me te momo hē, ki te 422.
  • E whakaaetia ana ngā header putanga me beta e tāpiria ana e ngā SDK (anthropic-version, anthropic-beta, openai-beta). Kāore tētahi o rātou e hiahiatia.
  • Ko te model o tētahi whakautu te id kua whakaputaina, nō reira ka taea e koe te tuku whakamuri pēnei i a ia.
  • I runga i te /v1/messages ka taea e tētahi whakautu te tīmata me tētahi poraka thinking. Pānuitia ngā poraka o te momo text kaua i te tango i te poraka tuatahi.
  • Ka mahi te streaming mā ngā kaiāwhina stream ake a te SDK. Ka tae mai te usage i te mutunga o ia stream.
  • Ka kawe ia whakautu i tētahi header x-request-id. Tukuna tō ake x-request-id, ā, ka hoki mai te uara ōrite.

Ngā SDK hapori

Ka mahi ngā kiritaki i tuhia mō te API OpenAI e ētahi atu kaituhi i te ara ōrite: hoatu ki te kiritaki te base URL me te /v1, tō key me tētahi id model Shannon. Ko ēnei e tiakina ana e ō rātou kaituhi, kaua e Shannon.

Reo Whakaurunga Kiritaki
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

Me te kore SDK

Kāore koe e hiahia ki tētahi SDK. Ka mahi tētahi kiritaki HTTP e taea ana te tuku JSON:

  • POST me tētahi tinana JSON me te header Content-Type: application/json. Ki te kore, ka whakautua te tono ki te 415.
  • Tō key i te Authorization: Bearer <key> i te x-api-key: <key> rānei. Ka mahi ngā mea e rua i ia endpoint.
  • He tinana tae atu ki te 32 MiB.
  • Ki te "stream": true he stream kaupapa server-sent te whakautu (text/event-stream). Pānuitia rārangi ki te rārangi, ā, kaua e buffer.
  • He tinana JSON te hapa me te error.type me te error.message, i te taha o te tūnga 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!"}]
  }'

Mō ngā kaupapa o tētahi stream me ngā momo hapa, tirohia: Rere Whakahaere hapa