உள்ளடக்கத்துக்குச் செல்
SDKகள்

SDKகள்

எந்த OpenAI அல்லது Anthropic SDK-யும் உடனடியாக வேலை செய்யும்.

Shannon OpenAI மற்றும் Anthropic wire வடிவங்கள் இரண்டையும் ஏற்கிறது; எனவே இரண்டின் அதிகாரப்பூர்வ SDK-களையும் அப்படியே பயன்படுத்தலாம். client-ல் மூன்று மதிப்புகளை மாற்றினால் போதும்: base URL, API key மற்றும் மாடல் id. உங்கள் மற்ற குறியீடு அப்படியே இருக்கும்.

எதை அமைக்க வேண்டும்

அமைப்பு OpenAI SDK-கள் Anthropic SDK-கள்
Base URL https://api.shannon-ai.com/v1 https://api.shannon-ai.com
API key உங்கள் Shannon key. SDK அதை Authorization: Bearer ஆக அனுப்புகிறது. உங்கள் Shannon key. SDK அதை x-api-key ஆக அனுப்புகிறது.
மாடல் வெளியிடப்பட்ட மாடல் id, எடுத்துக்காட்டாக shannon-3. வெளியிடப்பட்ட மாடல் id, எடுத்துக்காட்டாக shannon-1.6-lite.
அது அணுகும் endpoints /v1/chat/completions, /v1/responses, /v1/models /v1/messages, /v1/messages/count_tokens
சூழல் மாறிகள் (Environment variables) OPENAI_API_KEY மற்றும் OPENAI_BASE_URL; நீங்கள் மதிப்பு எதுவும் தராதபோது Python மற்றும் JavaScript SDK-கள் இவற்றைப் படிக்கும். ANTHROPIC_API_KEY மற்றும் ANTHROPIC_BASE_URL; நீங்கள் மதிப்பு எதுவும் தராதபோது Python மற்றும் TypeScript SDK-கள் இவற்றைப் படிக்கும்.

இரு base URL-களும் /v1 மூலம் வேறுபடுகின்றன: OpenAI SDK தனது base URL-உடன் /chat/completions-ஐச் சேர்க்கிறது, Anthropic SDK /v1/messages-ஐச் சேர்க்கிறது. Shannon வெளியிடாத மாடல் பெயருக்கு 400 மற்றும் unknown model என்ற பதில் வரும். மாடல்கள் & விலை

உங்கள் key Keys & usage பக்கத்தில் உள்ளது. Keys & usage

OpenAI SDK-கள்

அதிகாரப்பூர்வ OpenAI SDK-கள் POST /v1/chat/completions மற்றும் POST /v1/responses-ஐ அழைக்கின்றன. ஒவ்வொரு மாதிரியும் ஒரு பயனர் செய்தியை அனுப்பி பதிலை அச்சிடுகிறது.

# 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)
மொழி நிறுவல் Base URL விருப்பம் மூலம்
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

இந்த இரு endpoints-ன் ஒவ்வொரு புலமும் அவற்றின் தனிப் பக்கங்களில் விவரிக்கப்பட்டுள்ளது. Chat Completions Responses API

Anthropic SDK-கள்

அதிகாரப்பூர்வ Anthropic SDK-கள் POST /v1/messages-ஐ அழைக்கின்றன. ஒவ்வொரு அழைப்பிலும் அவை max_tokens-ஐக் கோருகின்றன; அதனால் மாதிரிகள் அதைச் செயல்படுத்தும் shannon-1.6-lite-ஐப் பயன்படுத்துகின்றன. ஒவ்வொரு மாதிரியும் பதிலின் text blocks-ஐ அச்சிடும்.

# 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)
மொழி நிறுவல் Base URL விருப்பம் மூலம்
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 வடிவமும் அதன் வேறுபாடுகளும் Anthropic இணக்கத்தன்மை பக்கத்தில் உள்ளன. மானுடவியல் வடிவம்

SDK-கள் எதை நம்பலாம்

  • API பயன்படுத்தாத கோரிக்கை புலம் ஏற்றுக்கொள்ளப்படும். API அறிந்த புலத்தை தவறான வகையில் அனுப்பினால் 422 பதில் வரும்.
  • SDK-கள் சேர்க்கும் version மற்றும் beta headers (anthropic-version, anthropic-beta, openai-beta) ஏற்றுக்கொள்ளப்படும். இவற்றில் எதுவும் கட்டாயம் இல்லை.
  • பதிலின் model என்பது வெளியிடப்பட்ட id; எனவே அதை அப்படியே திருப்பி அனுப்பலாம்.
  • /v1/messages-ல் பதில் thinking block உடன் தொடங்கலாம். முதல் block-ஐ எடுக்காமல், text வகை blocks-ஐப் படிக்கவும்.
  • Streaming SDK-யின் சொந்த stream helpers வழியாகச் செயல்படுகிறது. ஒவ்வொரு stream-ன் முடிவிலும் usage வரும்.
  • ஒவ்வொரு பதிலிலும் x-request-id header இருக்கும். உங்கள் சொந்த x-request-id-ஐ அனுப்பினால் அதே மதிப்பு திரும்ப வரும்.

சமூக SDK-கள்

பிற ஆசிரியர்கள் OpenAI API-க்காக எழுதிய clients அதே முறையில் செயல்படுகின்றன: client-க்கு /v1 உடன் base URL, உங்கள் key மற்றும் ஒரு Shannon மாடல் id-ஐக் கொடுக்கவும். இவற்றை அவற்றின் ஆசிரியர்கள் பராமரிக்கிறார்கள், Shannon அல்ல.

மொழி நிறுவல் 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

SDK இல்லாமல்

உங்களுக்கு SDK தேவையில்லை. JSON அனுப்பக்கூடிய எந்த HTTP client-ம் செயல்படும்:

  • JSON body மற்றும் Content-Type: application/json header உடன் POST. அது இல்லாவிட்டால் கோரிக்கைக்கு 415 பதில் வரும்.
  • உங்கள் key Authorization: Bearer <key>-ல் அல்லது x-api-key: <key>-ல். இரண்டும் ஒவ்வொரு endpoint-லும் செயல்படும்.
  • 32 MiB வரை உள்ள body.
  • "stream": true உடன் பதில் server-sent event stream (text/event-stream) ஆகும். அதை வரி வரியாகப் படிக்கவும்; buffer செய்ய வேண்டாம்.
  • பிழை என்பது HTTP நிலைக்குடன் error.type மற்றும் error.message கொண்ட JSON body ஆகும்.
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!"}]
  }'

stream-ன் நிகழ்வுகள் மற்றும் பிழை வகைகளுக்குப் பார்க்கவும்: ஸ்ட்ரீமிங் கையாளுவதில் பிழை