U gudub nuxurka
SDK-yo

SDK-yo

SDK kasta oo OpenAI ama Anthropic ah wuu shaqeeyaa isla markiiba.

Shannon wuxuu ku hadlaa qaababka xarigga OpenAI iyo Anthropic, sidaas darteed SDK-yada rasmiga ah ee labadaba waxaad u isticmaashaa sida ay yihiin. Waxaad macmiilka ku beddeshaa saddex qiime: base URL, furaha API iyo id-ga model-ka. Code-kaaga inta kale isku mid ayay ahaanaysaa.

Waxa la dejiyo

Dejin SDK-yada OpenAI SDK-yada Anthropic
Base URL https://api.shannon-ai.com/v1 https://api.shannon-ai.com
Furaha API Furahaaga Shannon. SDK-gu wuxuu u diraa sida Authorization: Bearer. Furahaaga Shannon. SDK-gu wuxuu u diraa sida x-api-key.
Model Id model la daabacay, tusaale ahaan shannon-3. Id model la daabacay, tusaale ahaan shannon-1.6-lite.
Endpoint-yada uu gaaro /v1/chat/completions, /v1/responses, /v1/models /v1/messages, /v1/messages/count_tokens
Environment variables OPENAI_API_KEY iyo OPENAI_BASE_URL, oo akhriya SDK-yada Python iyo JavaScript marka aadan gudbin qiime. ANTHROPIC_API_KEY iyo ANTHROPIC_BASE_URL, oo akhriya SDK-yada Python iyo TypeScript marka aadan gudbin qiime.

Labada base URL waxay ku kala duwan yihiin /v1: SDK OpenAI wuxuu ku daraa /chat/completions base URL-kiisa, SDK Anthropic wuxuu ku daraa /v1/messages. Magac model oo Shannon aan daabacin waxaa lagu jawaabaa 400 iyo unknown model. Model-yo & qiimo

Furahaagu wuxuu ku yaal bogga Fure & isticmaal. Fure & isticmaal

SDK-yada OpenAI

SDK-yada OpenAI ee rasmiga ah waxay wacaan POST /v1/chat/completions iyo POST /v1/responses. Tusaale kastaa wuxuu diraa hal fariin isticmaale wuxuuna daabacaa jawaabta.

# 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)
Luqad Rakib Ikhtiyaarka base URL Isha
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 kasta oo labada endpoint waxaa lagu sharaxay bogagooda gaarka ah. Chat Completions Responses API

SDK-yada Anthropic

SDK-yada Anthropic ee rasmiga ah waxay wacaan POST /v1/messages. Waxay u baahan yihiin max_tokens wicitaan kasta, sidaas darteed tusaalayaashu waxay isticmaalaan shannon-1.6-lite, kaas oo dabaqa. Tusaale kastaa wuxuu daabacaa blocks-ka qoraalka ee jawaabta.

# 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)
Luqad Rakib Ikhtiyaarka base URL Isha
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

Qaabka Messages iyo kala duwanaanshihiisa waxay ku yaalliin bogga waafaqsanaanta Anthropic. Qaabka Anthropic

Waxa SDK-yadu ku tiirsanaan karaan

  • Field codsi oo API-gu isticmaalin waa la aqbalaa. Field API-gu yaqaan, oo nooc qaldan lagu diray, waxaa lagu jawaabaa 422.
  • Header-yada version iyo beta ee SDK-yadu ku daraan (anthropic-version, anthropic-beta, openai-beta) waa la aqbalaa. Midna looma baahna.
  • model ee jawaab waa id-ga la daabacay, sidaas darteed dib ugu diri kartaa sida uu yahay.
  • /v1/messages jawaab waxay ku bilaabmi kartaa block thinking. Akhri blocks-ka nooca text halkii aad qaadan lahayd block-ga ugu horreeya.
  • Streaming wuxuu ku shaqeeyaa stream helpers-ka SDK laftiisa. Usage wuxuu imaanayaa dhammaadka stream kasta.
  • Jawaab kasta waxay sidaa header x-request-id. Dir x-request-id aad leedahay isla qiimahaas ayaa soo noqda.

SDK-yada bulshada

Macaamiisha loogu qoray API-ga OpenAI ee qorayaal kale waxay u shaqeeyaan si isku mid ah: macmiilka sii base URL-ka oo leh /v1, furahaaga iyo id model Shannon ah. Kuwani waxaa dayactira qorayaashooda, ma aha Shannon.

Luqad Rakib Macmiil
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

SDK la'aan

SDK uma baahnid. Macmiil HTTP kasta oo diri kara JSON wuu shaqeeyaa:

  • POST oo leh jidh JSON ah iyo header-ka Content-Type: application/json. La'aantiis codsiga waxaa lagu jawaabaa 415.
  • Furahaaga Authorization: Bearer <key> ama x-api-key: <key>. Labaduba waxay ka shaqeeyaan endpoint kasta.
  • Jidh ilaa 32 MiB.
  • Marka "stream": true jawaabtu waa stream server-sent event ah (text/event-stream). Xariiq-xariiq akhri oo ha buffer-gareynin.
  • Khaladku waa jidh JSON ah oo leh error.type iyo error.message, xaaladda HTTP agteeda.
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!"}]
  }'

Events-ka stream iyo noocyada khaladka, eeg: Streaming Khaladaadka Maareynta