Léim go dtí an t-ábhar
SDKanna

SDKanna

Oibríonn aon SDK OpenAI nó Anthropic díreach as an bhosca.

Labhraíonn Shannon formáidí sreinge OpenAI agus Anthropic, mar sin úsáideann tú SDKanna oifigiúla an dá cheann mar atá siad. Athraíonn tú trí luach sa chliant: an bun-URL, an eochair API agus id an mhúnla. Fanann an chuid eile de do chód mar a bhí.

Cad atá le socrú

Socrú SDKanna OpenAI SDKanna Anthropic
Bun-URL https://api.shannon-ai.com/v1 https://api.shannon-ai.com
Eochair API D'eochair Shannon. Seolann an SDK í mar Authorization: Bearer. D'eochair Shannon. Seolann an SDK í mar x-api-key.
Múnla Id múnla foilsithe, mar shampla shannon-3. Id múnla foilsithe, mar shampla shannon-1.6-lite.
Críochphointí a shroicheann sé /v1/chat/completions, /v1/responses, /v1/models /v1/messages, /v1/messages/count_tokens
Athróga timpeallachta OPENAI_API_KEY agus OPENAI_BASE_URL, léite ag SDKanna Python agus JavaScript nuair nach gcuireann tú luach ar fáil. ANTHROPIC_API_KEY agus ANTHROPIC_BASE_URL, léite ag SDKanna Python agus TypeScript nuair nach gcuireann tú luach ar fáil.

Tá difríocht /v1 idir an dá bhun-URL: cuireann SDK OpenAI /chat/completions lena bhun-URL, cuireann SDK Anthropic /v1/messages leis. Freagraítear ainm múnla nach bhfoilsíonn Shannon le 400 agus unknown model. Múnlaí agus praghsáil

Tá d'eochair ar an leathanach Eochracha agus úsáid. Eochracha agus úsáid

SDKanna OpenAI

Glaonn na SDKanna oifigiúla OpenAI ar POST /v1/chat/completions agus POST /v1/responses. Seolann gach sampla teachtaireacht úsáideora amháin agus priontálann sé an freagra.

# 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)
Teanga Suiteáil Rogha bun-URL Foinse
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

Déantar cur síos ar gach réimse den dá chríochphointe ar leathanaigh dá gcuid féin. Chat Completions Responses API

SDKanna Anthropic

Glaonn na SDKanna oifigiúla Anthropic ar POST /v1/messages. Éilíonn siad max_tokens ar gach glao, mar sin úsáideann na samplaí shannon-1.6-lite, a chuireann i bhfeidhm é. Priontálann gach sampla bloic téacs an fhreagra.

# 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)
Teanga Suiteáil Rogha bun-URL Foinse
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

Tá an fhormáid Messages agus a difríochtaí ar an leathanach comhoiriúnachta Anthropic. Formáid Antraipeach

Cad ar féidir leis na SDKanna brath air

  • Glactar le réimse iarratais nach n-úsáideann an API. Freagraítear le 422 ar réimse a bhfuil aithne ag an API air, seolta leis an gcineál mícheart.
  • Glactar leis na ceanntásca leagain agus béite a chuireann na SDKanna leis (anthropic-version, anthropic-beta, openai-beta). Níl aon cheann acu riachtanach.
  • Is é an id foilsithe model freagra, mar sin is féidir leat é a sheoladh ar ais mar atá.
  • Ar /v1/messages is féidir le freagra tosú le bloc thinking. Léigh na bloic den chineál text in ionad an chéad bhloc a thógáil.
  • Oibríonn sruthú trí chúntóirí sruthaithe an SDK féin. Tagann úsáid ag deireadh gach sruth.
  • Iompraíonn gach freagra ceanntásc x-request-id. Seol do x-request-id féin agus filleann an luach céanna.

SDKanna pobail

Oibríonn cliaint a scríobh údair eile don API OpenAI ar an gcaoi chéanna: tabhair an bun-URL le /v1, d'eochair agus id múnla Shannon don chliant. Cothaíonn a n-údair iad seo, ní Shannon.

Teanga Suiteáil Cliant
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

Gan SDK

Níl SDK ag teastáil uait. Oibríonn aon chliant HTTP is féidir JSON a sheoladh:

  • POST le corp JSON agus an ceanntásc Content-Type: application/json. Gan é freagraítear an t-iarratas le 415.
  • D'eochair in Authorization: Bearer <key> nó in x-api-key: <key>. Oibríonn an dá cheann ar gach críochphointe.
  • Corp suas le 32 MiB.
  • Le "stream": true is sruth server-sent events (text/event-stream) é an freagra. Léigh líne ar líne é agus ná déan maolú air.
  • Is corp JSON le error.type agus error.message é earráid, in aice leis an stádas 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!"}]
  }'

Le haghaidh imeachtaí sruth agus na gcineálacha earráide, féach: Sruthú Láimhseáil Earráide