Leum gun t-susbaint
Endpoints crioptaichte, Tor & I2P

Endpoints crioptaichte, Tor & I2P

Tha an API air fhoillseachadh cuideachd mar sheirbheis onion Tor agus eepsite I2P. Na h-aon slighean, an aon iuchair; chan atharraich ach am base URL agus am proxy.

Base URLs

Tha ceithir seòlaidhean a’ leantainn chun an aon API. Cleachd am fear a fhreagras air do lìonra, leis an aon iuchair API agus na h-aon iarrtasan.

Lìonra Base URL Mar a ruigeas tu e
An lìon fosgailte https://api.shannon-ai.com/v1 Dìreach, thairis air HTTPS.
Mirror crioptaichte https://api-encrypted.shannon-ai.com/v1 Dìreach, thairis air HTTPS. Dàrna ainm òstair airson an aon API.
Tor (seirbheis onion) http://shannonmd773o5vxz75byha5rkea7nzr3srotw46uwythq3pjl6y4cad.onion/v1 Tro client Tor: proxy SOCKS5, a ghnàth aig 127.0.0.1:9050.
I2P (eepsite) http://acvnvkdea4xaczzjap7chysqqi4kkvp2eorfwkasindzmjpa47da.b32.i2p/v1 Tro router I2P: proxy HTTP, a ghnàth aig 127.0.0.1:4444.
  • Gabhaidh OpenAI SDK am base URL mar a tha e air a shealltainn, le /v1. Gabhaidh Anthropic SDK e gun /v1.
  • Gus seòladh a dhearbhadh, leugh headers freagairt https://api.shannon-ai.com: tha Onion-Location a’ giùlan seòladh an onion agus X-I2P-Location seòladh I2P. Tòisichidh seòladh an onion le shannon.

Dè na slighean a dh’obraicheas

Freagraidh gach slighe /v1 air na ceithir seòlaidhean uile:

  • POST /v1/chat/completions
  • POST /v1/responses
  • POST /v1/messages
  • POST /v1/messages/count_tokens
  • POST /v1/tokenize
  • GET /v1/models

Chan eil feum air iuchair air GET /v1/models, agus mar sin is e deuchainn luath a th’ ann gu bheil do proxy a’ ruighinn an API.

Dè a tha an aon rud agus dè a tha eadar-dhealaichte

Nì An aon rud? Mion-fhiosrachadh
Slighean, raointean iarrtais, freagairtean, mearachdan An aon rud An aon rud air gach seòladh. Chan eil slighe sam bith ag obair air dhòigh eile a-rèir ainm an òstair.
Iuchair API An aon rud Obraichidh aon iuchair air gach seòladh, mar Authorization: Bearer no x-api-key. Chan eil cookies air an leughadh air /v1 a-chaoidh.
Balance agus crìochan An aon rud An aon balance agus an aon chrìoch de 120 iarrtas gach mionaid. Tha an dà chuid air an cunntadh gach cunntas, chan ann gach seòladh.
Meud iarrtais An aon rud Suas gu 32 MiB gach bodhaig iarrtais.
Sgeama Eadar-dhealaichte https:// air an lìon fhosgailte agus air a’ mhirror. http:// air na seòlaidhean .onion agus .b32.i2p, far a bheil an lìonra fhèin a’ crioptachadh a’ cheangail o cheann gu ceann.
Proxy Eadar-dhealaichte Chan eil gin air an lìon fhosgailte. Proxy SOCKS5 airson Tor, proxy HTTP airson I2P. Feumaidh am proxy an t-ainm fhuasgladh, chan e an inneal agad.
Astar Eadar-dhealaichte Cuiridh an dà lìonra dàil ris gach byte. Is e I2P am fear as slaodaiche dhen dithis.

Tha balance agus crìochan air am mìneachadh air duilleag fhèin. Crìochan agus balance

cURL tro Tor

Ruith client Tor air an inneal agad. Tabhainnidh e proxy SOCKS5 air 127.0.0.1:9050. Bheir --socks5-hostname an t-ainm .onion dhan proxy sin.

cURL · Tor
# 1. Is the onion service reachable? No key needed.
curl --socks5-hostname 127.0.0.1:9050 http://shannonmd773o5vxz75byha5rkea7nzr3srotw46uwythq3pjl6y4cad.onion/v1/models

# 2. A streamed chat call. -N prints the stream as it arrives.
curl -N --socks5-hostname 127.0.0.1:9050 http://shannonmd773o5vxz75byha5rkea7nzr3srotw46uwythq3pjl6y4cad.onion/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-3",
    "stream": true,
    "messages": [{"role": "user", "content": "Hello over Tor"}]
  }'

cURL tro I2P

Ruith router I2P air an inneal agad. Tabhainnidh e proxy HTTP air 127.0.0.1:4444, a ghabhas an t-ainm .b32.i2p mar a tha e.

cURL · I2P
# 1. Is the eepsite reachable? No key needed.
curl --proxy http://127.0.0.1:4444 http://acvnvkdea4xaczzjap7chysqqi4kkvp2eorfwkasindzmjpa47da.b32.i2p/v1/models

# 2. A streamed chat call.
curl -N --proxy http://127.0.0.1:4444 http://acvnvkdea4xaczzjap7chysqqi4kkvp2eorfwkasindzmjpa47da.b32.i2p/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-3",
    "stream": true,
    "messages": [{"role": "user", "content": "Hello over I2P"}]
  }'

Base URL SDK

Tha feum aig SDK air dà atharrachadh: base URL an lìonraidh, agus client HTTP a thèid tron proxy. Ann am Python gabhaidh an dà SDK oifigeil client httpx. Airson proxy SOCKS stàlaich httpx[socks].

# pip install openai "httpx[socks]"
import httpx
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="http://shannonmd773o5vxz75byha5rkea7nzr3srotw46uwythq3pjl6y4cad.onion/v1",
    http_client=httpx.Client(proxy="socks5h://127.0.0.1:9050", timeout=600),
)

stream = client.chat.completions.create(
    model="shannon-3",
    messages=[{"role": "user", "content": "Hello over Tor"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Obraichidh streaming thairis air an dà lìonra. Fhad ’s a tha stream fosgailte agus gun dad aig a’ mhodail ri chur fhathast, cuiridh an API keep-alive, gus nach bi coltas marbh air a’ cheangal do proxy no dhan client agad.

Endpoint Keep-alive air stream fosgailte Air a chur airson
/v1/chat/completions Loidhne bheachd (tòisichidh i le :) gach 15 diogan. A h-uile modail
/v1/messages event: ping, no loidhne bheachd, gach 15 diogan. A h-uile modail
/v1/responses Loidhne bheachd gach 15 diogan. Modailean open-weight hosted
  • Cuir "stream": true. Tòisichidh freagairt le streaming a’ ruighinn cho luath ’s a sgrìobhas am modail, agus seallaidh an keep-alive gu bheil an t-iarrtas fhathast ga obrachadh. Cha chuir freagairt gun streaming dad gus am bi am freagairt gu lèir deiseil.
  • Thoir timeout leughaidh fada dhan client. Tha na sampaill a’ cleachdadh 600 diogan. Faodaidh timeout nas giorra na 15 diogan stream a chrìochnachadh eadar dà keep-alive.
  • Leig le do leughadair SSE leum thairis air loidhnichean beachd agus tachartasan ping. Nì na SDKan sin mu thràth.
  • Na cuir iarrtas a-rithist sa bhad nuair a thuiteas ceangal. Ruithidh iarrtas a ràinig an API chun a dheireadh agus thèid a chunntadh, cuideachd nuair a tha an ceangal air a dhol.
  • Feuch an t-slighe le GET /v1/models an toiseach. Chan eil feum air iuchair agus tillidh e liosta JSON ghoirid.

Duilgheadasan ceangail

Comharra Adhbhar agus càireadh
Thèid an ceangal gu 127.0.0.1:9050 no 127.0.0.1:4444 a dhiùltadh Chan eil client Tor no router I2P a’ ruith air an inneal agad, no tha e ag èisteachd air port eile. Tabhainnidh Tor Browser a proxy SOCKS air port 9150.
Could not resolve host airson an ainm .onion Dh’fheuch an client an t-ainm fhuasgladh fhèin. Cleachd --socks5-hostname ann an cURL agus socks5h:// ann an URL proxy, gus am fuasgail an client Tor e.
Freagraidh proxy I2P le duilleag mhearachd fhèin Chan eil an router air an seòladh a lorg fhathast. Feumaidh router beagan mhionaidean às dèidh dha tòiseachadh. Feuch a-rithist.
401 le Missing authentication Ràinig an t-iarrtas gun iuchair. Cuir an aon header ri air an lìon fhosgailte.

Tha a h-uile mearachd eile mar a tha i air an lìon fhosgailte. Làimhseachadh mearachd

D’ iuchair gun JavaScript

Tha làrach-lìn gun JavaScript aig Shannon cuideachd, ri ruighinn air an lìon fhosgailte, mar sheirbheis onion agus mar eepsite. Seallaidh an duilleag /keys aice d’ iuchair API agus leigidh i leat a h-ùrachadh, agus mar sin faodaidh tu iuchair fhaighinn gun Tor no I2P fhàgail. encrypted.shannon-ai.com/keys

Tha seòlaidhean na làraich-lìn sin air na trì lìonraidhean uile air an liostadh an seo: Ruigsinneachd chrioptaichte