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: thaOnion-Locationa’ giùlan seòladh an onion agusX-I2P-Locationseòladh I2P. Tòisichidh seòladh an onion leshannon.
Dè na slighean a dh’obraicheas
Freagraidh gach slighe /v1 air na ceithir seòlaidhean uile:
POST /v1/chat/completionsPOST /v1/responsesPOST /v1/messagesPOST /v1/messages/count_tokensPOST /v1/tokenizeGET /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.
# 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.
# 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) # pip install openai
import httpx
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="http://acvnvkdea4xaczzjap7chysqqi4kkvp2eorfwkasindzmjpa47da.b32.i2p/v1",
http_client=httpx.Client(proxy="http://127.0.0.1:4444", timeout=600),
)
stream = client.chat.completions.create(
model="shannon-3",
messages=[{"role": "user", "content": "Hello over I2P"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True) # pip install anthropic "httpx[socks]"
import anthropic
import httpx
client = anthropic.Anthropic(
api_key="YOUR_API_KEY",
base_url="http://shannonmd773o5vxz75byha5rkea7nzr3srotw46uwythq3pjl6y4cad.onion",
http_client=httpx.Client(proxy="socks5h://127.0.0.1:9050", timeout=600),
)
with client.messages.stream(
model="shannon-1.6-lite",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello over Tor"}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True) Streaming agus keep-alive air ceanglaichean slaodach
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/modelsan 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