Léim go dtí an t-ábhar
Críochphointí criptithe, Tor & I2P

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íonn Onion-Location an seoladh onion agus X-I2P-Location an seoladh I2P. Tosaíonn an seoladh onion le shannon.

Cé acu bealaí a oibríonn

Freagraíonn gach bealach /v1 ar na ceithre sheoladh uile:

  • POST /v1/chat/completions
  • POST /v1/responses
  • POST /v1/messages
  • POST /v1/messages/count_tokens
  • POST /v1/tokenize
  • GET /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.

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 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á.

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"}]
  }'

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)

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í ping a 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/models ar 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