Fò lọ sí àkóónú
Awọn SDK

Awọn SDK

Èyíkéyìí SDK OpenAI tàbí Anthropic ń ṣiṣẹ́ láìsí àfikún ìṣètò kankan.

Shannon ń sọ àwọn ọ̀nà wire OpenAI àti Anthropic, nítorí náà o ń lo àwọn SDK tí a fọwọ́ sí ti méjèèjì bí wọ́n ṣe wà. O yí iye mẹ́ta padà nínú client: base URL, API key àti id model. Ìyókù code rẹ ń dúró bákan náà.

Ohun tí a ó ṣètò

Ètò Àwọn SDK OpenAI Àwọn SDK Anthropic
Base URL https://api.shannon-ai.com/v1 https://api.shannon-ai.com
API key Key Shannon rẹ. SDK ń fi ránṣẹ́ bí Authorization: Bearer. Key Shannon rẹ. SDK ń fi ránṣẹ́ bí x-api-key.
Model Id model tí a tẹ̀ jáde, fún àpẹẹrẹ shannon-3. Id model tí a tẹ̀ jáde, fún àpẹẹrẹ shannon-1.6-lite.
Àwọn endpoint tó ń dé /v1/chat/completions, /v1/responses, /v1/models /v1/messages, /v1/messages/count_tokens
Àwọn environment variable OPENAI_API_KEY àti OPENAI_BASE_URL, tí àwọn SDK Python àti JavaScript ń kà nígbà tí o kò bá fi iye kankan ránṣẹ́. ANTHROPIC_API_KEY àti ANTHROPIC_BASE_URL, tí àwọn SDK Python àti TypeScript ń kà nígbà tí o kò bá fi iye kankan ránṣẹ́.

Àwọn base URL méjèèjì yàtọ̀ nípasẹ̀ /v1: SDK OpenAI ń fi /chat/completions kún base URL rẹ̀, SDK Anthropic ń fi /v1/messages kún. Orúkọ model tí Shannon kò tẹ̀ jáde ni a ń dáhùn pẹ̀lú 400 àti unknown model. Àwọn model àti iye owó

Key rẹ wà lórí ojú-ìwé Àwọn key àti ìlò. Àwọn key àti ìlò

Àwọn SDK OpenAI

Àwọn SDK OpenAI tí a fọwọ́ sí ń pe POST /v1/chat/completions àti POST /v1/responses. Àpẹẹrẹ kọ̀ọ̀kan ń fi ìfiránṣẹ́ user kan ránṣẹ́, ó sì ń tẹ ìdáhùn jáde.

# 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)
Èdè Fi sórí ẹ̀rọ Àṣàyàn base URL Orísun
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

A ṣàpèjúwe gbogbo field ti àwọn endpoint méjèèjì lórí ojú-ìwé tiwọn. Chat Completions Responses API

Àwọn SDK Anthropic

Àwọn SDK Anthropic tí a fọwọ́ sí ń pe POST /v1/messages. Wọ́n nílò max_tokens lórí ìpè kọ̀ọ̀kan, nítorí náà àwọn àpẹẹrẹ ń lo shannon-1.6-lite, èyí tó ń lò ó. Àpẹẹrẹ kọ̀ọ̀kan ń tẹ àwọn block ọ̀rọ̀ ti ìdáhùn jáde.

# 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)
Èdè Fi sórí ẹ̀rọ Àṣàyàn base URL Orísun
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

Ọ̀nà Messages àti àwọn ìyàtọ̀ rẹ̀ wà lórí ojú-ìwé ìbáramu Anthropic. Anthropic kika

Ohun tí àwọn SDK lè gbẹ́kẹ̀lé

  • A gba field ìbéèrè tí API kò lò. Field tí API mọ̀, tí a fi ránṣẹ́ pẹ̀lú irú tí kò tọ̀, ni a ń dáhùn pẹ̀lú 422.
  • A gba àwọn header version àti beta tí àwọn SDK ń fi kún (anthropic-version, anthropic-beta, openai-beta). Kò sí èyí tó jẹ́ dandan.
  • model ti èsì jẹ́ id tí a tẹ̀ jáde, nítorí náà o lè fi ránṣẹ́ padà bí ó ṣe wà.
  • Lórí /v1/messages, èsì lè bẹ̀rẹ̀ pẹ̀lú block thinking. Ka àwọn block ti irú text dípò kí o mú block àkọ́kọ́.
  • Streaming ń ṣiṣẹ́ nípasẹ̀ àwọn stream helper ti SDK fúnra rẹ̀. Usage ń dé ní òpin gbogbo stream.
  • Gbogbo èsì ń gbé header x-request-id. Fi x-request-id tìrẹ ránṣẹ́, iye kan náà yóò sì padà wá.

Àwọn SDK àwùjọ

Àwọn client tí àwọn òǹkọ̀wé mìíràn kọ fún API OpenAI ń ṣiṣẹ́ ní ọ̀nà kan náà: fún client ní base URL pẹ̀lú /v1, key rẹ àti id model Shannon. Àwọn òǹkọ̀wé wọn ló ń tọ́jú wọ́n, kì í ṣe Shannon.

Èdè Fi sórí ẹ̀rọ 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

Láìsí SDK

O kò nílò SDK. Client HTTP èyíkéyìí tó lè fi JSON ránṣẹ́ ń ṣiṣẹ́:

  • POST pẹ̀lú body JSON àti header Content-Type: application/json. Láìsí i, a ń dáhùn ìbéèrè náà pẹ̀lú 415.
  • Key rẹ nínú Authorization: Bearer <key> tàbí nínú x-api-key: <key>. Méjèèjì ń ṣiṣẹ́ lórí gbogbo endpoint.
  • Body títí dé 32 MiB.
  • Pẹ̀lú "stream": true, èsì jẹ́ stream server-sent event (text/event-stream). Kà á ní ìlà-ìlà kí o má sì ṣe buffer rẹ̀.
  • Àṣìṣe jẹ́ body JSON pẹ̀lú error.type àti error.message, lẹ́gbẹ̀ẹ́ HTTP 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!"}]
  }'

Fún àwọn event ti stream àti àwọn irú àṣìṣe, wo: Sisanwọle Mimu Aṣiṣe