Simira kuzvirimo
SDKs

SDKs

SDK ipi neipi ye-OpenAI kana Anthropic inoshanda pakarepo.

Shannon inotaura OpenAI ne-Anthropic wire formats, saka unoshandisa official SDKs dzese dzimbiri sezvadziri. Unochinja values nhatu mu-client: base URL, API key ne-model id. Zvimwe zve-code yako zvinoramba zvakadaro.

Zvekuisa

Setting OpenAI SDKs Anthropic SDKs
Base URL https://api.shannon-ai.com/v1 https://api.shannon-ai.com
API key Shannon key yako. SDK inoitumira se-Authorization: Bearer. Shannon key yako. SDK inoitumira se-x-api-key.
Model Published model id, semuenzaniso shannon-3. Published model id, semuenzaniso shannon-1.6-lite.
Endpoints yainosvika /v1/chat/completions, /v1/responses, /v1/models /v1/messages, /v1/messages/count_tokens
Environment variables OPENAI_API_KEY ne-OPENAI_BASE_URL, dzinoverengwa ne-Python ne-JavaScript SDKs kana usina kupa value. ANTHROPIC_API_KEY ne-ANTHROPIC_BASE_URL, dzinoverengwa ne-Python ne-TypeScript SDKs kana usina kupa value.

Base URLs mbiri dzinosiyana ne-/v1: OpenAI SDK inowedzera /chat/completions ku-base URL yayo, Anthropic SDK inowedzera /v1/messages. Zita re-model risingaburitswi neShannon rinopindurwa ne-400 ne-unknown model. Ma-model nemitengo

Key yako iri papeji reKeys & usage. Keys & usage

OpenAI SDKs

Official OpenAI SDKs dzinodanidzira POST /v1/chat/completions ne-POST /v1/responses. Sample imwe neimwe inotumira user message imwe uye inoprinta mhinduro.

# 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)
Mutauro Install Base URL option 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

Field imwe neimwe ye-endpoints mbiri idzi yakatsanangurwa mapeji ayo. Chat Completions Responses API

Anthropic SDKs

Official Anthropic SDKs dzinodanidzira POST /v1/messages. Dzinoda max_tokens pa-call imwe neimwe, saka ma-sample anoshandisa shannon-1.6-lite, inoishandisa. Sample imwe neimwe inoprinta text blocks dzemhinduro.

# 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)
Mutauro Install Base URL option 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

Messages format nezvinosiyana nayo zviri papeji re-Anthropic compatibility. Anthropic

Zvinogona kuvimbwa ne-SDKs

  • Request field isingashandiswi ne-API inogamuchirwa. Field inozikanwa ne-API, yakatumirwa ne-type isiriyo, inopindurwa ne-422.
  • Version ne-beta headers dzinowedzerwa ne-SDKs (anthropic-version, anthropic-beta, openai-beta) dzinogamuchirwa. Hapana inodiwa.
  • model yemhinduro ndiyo published id, saka unogona kuidzorera sezvairi.
  • Pa-/v1/messages mhinduro inogona kutanga ne-thinking block. Verenga blocks dze-type text panzvimbo pekutora block yekutanga.
  • Streaming inoshanda kuburikidza ne-stream helpers dze-SDK pachayo. Usage inosvika pakupera kwe-stream imwe neimwe.
  • Mhinduro imwe neimwe inotakura x-request-id header. Tumira x-request-id yako uye value imwechete inodzoka.

Community SDKs

Clients dzakanyorerwa OpenAI API nevamwe vanyori dzinoshanda nenzira imwechete: ipa client base URL ine /v1, key yako ne-Shannon model id. Idzi dzinochengetwa nevanyori vadzo, kwete neShannon.

Mutauro Install 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

Pasina SDK

Hauna kufanira SDK. HTTP client ipi neipi inogona kutumira JSON inoshanda:

  • POST ine JSON body ne-header Content-Type: application/json. Pasina iyo request inopindurwa ne-415.
  • Key yako mu-Authorization: Bearer <key> kana mu-x-api-key: <key>. Dzese dzinoshanda pa-endpoint imwe neimwe.
  • Body inosvika ku-32 MiB.
  • Ne-"stream": true mhinduro i-server-sent event stream (text/event-stream). Iverenge mutsara nemutsara uye usaichengete mu-buffer.
  • Error i-JSON body ine error.type ne-error.message, padivi peHTTP status.
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!"}]
  }'

Kuti uone ma-event e-stream nemhando dze-error, tarisa: Kuyerera Zvikanganiso