Críochphointí criptithe, Tor & I2P
Foilsítear an API freisin mar sheirbhís onion Tor agus mar eepsite I2P. Na bealaí céanna, an eochair chéanna; ní athraíonn ach an bun-URL agus an seachfhreastalaí.
Bun-URLanna
Treoraíonn ceithre sheoladh chuig an API céanna. Úsáid an ceann a oireann do do líonra, leis an eochair API chéanna agus na hiarratais chéanna.
| Líonra | Bun-URL | Conas a shroicheann tú é |
|---|---|---|
| Gréasán soiléir | https://api.shannon-ai.com/v1 | Go díreach, thar HTTPS. |
| Scáthán criptithe | https://api-encrypted.shannon-ai.com/v1 | Go díreach, thar HTTPS. Dara óstainm don API céanna. |
| Tor (seirbhís onion) | http://shannonmd773o5vxz75byha5rkea7nzr3srotw46uwythq3pjl6y4cad.onion/v1 | Trí chliant Tor: seachfhreastalaí SOCKS5, ag 127.0.0.1:9050 de réir réamhshocraithe. |
| I2P (eepsite) | http://acvnvkdea4xaczzjap7chysqqi4kkvp2eorfwkasindzmjpa47da.b32.i2p/v1 | Trí ródaire I2P: seachfhreastalaí HTTP, ag 127.0.0.1:4444 de réir réamhshocraithe. |
- Glacann SDK OpenAI leis an mbun-URL mar atá léirithe, le
/v1. Glacann SDK Anthropic leis gan/v1. - Chun seoladh a sheiceáil, léigh ceanntásca freagra
https://api.shannon-ai.com: iompraíonnOnion-Locationan seoladh onion agusX-I2P-Locationan seoladh I2P. Tosaíonn an seoladh onion leshannon.
Cé acu bealaí a oibríonn
Freagraíonn gach bealach /v1 ar na ceithre sheoladh uile:
POST /v1/chat/completionsPOST /v1/responsesPOST /v1/messagesPOST /v1/messages/count_tokensPOST /v1/tokenizeGET /v1/models
Ní theastaíonn eochair ó GET /v1/models, rud a fhágann gur tástáil thapa é go sroicheann do sheachfhreastalaí an API.
Cad atá mar a chéile agus cad atá difriúil
| Mír | An céanna? | Sonra |
|---|---|---|
| Bealaí, réimsí iarratais, freagraí, earráidí | Mar a chéile | An rud céanna ar gach seoladh. Ní iompraíonn aon bhealach go difriúil de réir óstainm. |
| Eochair API | Mar a chéile | Oibríonn eochair amháin ar gach seoladh, mar Authorization: Bearer nó x-api-key. Ní léitear fianáin riamh ar /v1. |
| Iarmhéid agus teorainneacha | Mar a chéile | An t-iarmhéid céanna agus an teorainn chéanna 120 iarratas in aghaidh an nóiméid. Áirítear an dá cheann in aghaidh an chuntais, ní in aghaidh an tseolta. |
| Méid an iarratais | Mar a chéile | Suas le 32 MiB in aghaidh chorp an iarratais. |
| Scéim | Difriúil | https:// ar an ngréasán soiléir agus ar an scáthán. http:// ar na seoltaí .onion agus .b32.i2p, áit a ndéanann an líonra féin an nasc a chriptiú ó cheann go ceann. |
| Seachfhreastalaí | Difriúil | Ceann ar bith ar an ngréasán soiléir. Seachfhreastalaí SOCKS5 do Tor, seachfhreastalaí HTTP d'I2P. Caithfidh an seachfhreastalaí an t-ainm a réiteach, ní do mheaisín. |
| Luas | Difriúil | Cuireann an dá líonra moill le gach beart. Is é I2P an ceann is moille den dá cheann. |
Déantar cur síos ar iarmhéid agus teorainneacha ar leathanach dá gcuid féin. Teorainneacha agus iarmhéid
cURL trí Tor
Rith cliant Tor ar do mheaisín. Cuireann sé seachfhreastalaí SOCKS5 ar fáil ag 127.0.0.1:9050. Tugann --socks5-hostname an t-ainm .onion don seachfhreastalaí 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 trí I2P
Rith ródaire I2P ar do mheaisín. Cuireann sé seachfhreastalaí HTTP ar fáil ag 127.0.0.1:4444, a ghlacann leis an ainm .b32.i2p mar atá.
# 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"}]
}' Bun-URL SDK
Teastaíonn dhá athrú ó SDK: bun-URL an líonra, agus cliant HTTP a théann tríd an seachfhreastalaí. In Python glacann an dá SDK oifigiúil le cliant httpx. Do sheachfhreastalaí SOCKS suiteáil 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) Sruthú agus keep-alive ar naisc mhall
Oibríonn sruthú thar an dá líonra. Fad a bhíonn sruth oscailte agus nach bhfuil faic le seoladh ag an múnla fós, seolann an API keep-alive, ionas nach mbeidh cuma mharbh ar an nasc ar sheachfhreastalaí nó ar do chliant.
| Críochphointe | Keep-alive ar shruth oscailte | Seolta do |
|---|---|---|
/v1/chat/completions | Líne nóta tráchta (tosaíonn sí le :) gach 15 soicind. | Gach múnla |
/v1/messages | event: ping, nó líne nóta tráchta, gach 15 soicind. | Gach múnla |
/v1/responses | Líne nóta tráchta gach 15 soicind. | Múnlaí open-weight óstáilte |
- Seol
"stream": true. Tosaíonn freagra sruthaithe ag teacht a luaithe a scríobhann an múnla, agus léiríonn an keep-alive go bhfuil an t-iarratas á láimhseáil fós. Ní sheolann freagra gan sruthú faic go dtí go mbíonn an freagra iomlán réidh. - Tabhair teorainn ama léite fhada don chliant. Úsáideann na samplaí 600 soicind. Is féidir le teorainn ama níos giorra ná 15 soicind sruth a bhriseadh idir dhá keep-alive.
- Lig do do léitheoir SSE línte nótaí tráchta agus imeachtaí
pinga scipeáil. Déanann na SDKanna é seo cheana. - Ná seol iarratas arís an nóiméad a thitfidh nasc. Ritheann iarratas a shroich an API go dtí a dheireadh agus áirítear é, fiú nuair a bhíonn an nasc imithe.
- Tástáil an cosán le
GET /v1/modelsar dtús. Ní theastaíonn eochair uaidh agus filleann sé liosta JSON gearr.
Fadhbanna nasctha
| Comhartha | Cúis agus réiteach |
|---|---|
Diúltaítear don nasc le 127.0.0.1:9050 nó 127.0.0.1:4444 | Níl aon chliant Tor ná ródaire I2P ag rith ar do mheaisín, nó éisteann sé ar phort eile. Cuireann Tor Browser a sheachfhreastalaí SOCKS ar fáil ar phort 9150. |
Could not resolve host don ainm .onion | Rinne an cliant iarracht an t-ainm a réiteach é féin. Úsáid --socks5-hostname in cURL agus socks5h:// in URL seachfhreastalaí, ionas go réitíonn an cliant Tor é. |
| Freagraíonn an seachfhreastalaí I2P lena leathanach earráide féin | Níor aimsigh an ródaire an seoladh fós. Teastaíonn cúpla nóiméad ó ródaire tar éis dó tosú. Bain triail eile as. |
401 le Missing authentication | Tháinig an t-iarratas gan eochair. Seol an ceanntásc céanna agus a sheolann tú ar an ngréasán soiléir. |
Tá gach earráid eile mar a chéile leis an ngréasán soiléir. Láimhseáil Earráide
D'eochair gan JavaScript
Tá suíomh gréasáin gan JavaScript ag Shannon freisin, inrochtana ar an ngréasán soiléir, mar sheirbhís onion agus mar eepsite. Taispeánann a leathanach /keys d'eochair API agus ligeann sé duit í a rothlú, mar sin is féidir leat eochair a fháil gan Tor ná I2P a fhágáil. encrypted.shannon-ai.com/keys
Liostaítear seoltaí an tsuímh gréasáin sin ar na trí líonra anseo: Rochtain chriptithe