Tlola ho ea ho litaba
Li-endpoint tse ngotsoeng, Tor le I2P

Li-endpoint tse ngotsoeng, Tor le I2P

API e boetse e phatlalatsoa e le Tor onion service le I2P eepsite. Litsela tse tšoanang, senotlolo se tšoanang; ke base URL le proxy feela tse fetohang.

Li-base URL

Liaterese tse nne li isa ho API e le 'ngoe. Sebelisa e loketseng marang-rang a hau, ka senotlolo sa API se tšoanang le likopo tse tšoanang.

Marang-rang Base URL Hore na u e fihlella joang
Clear web https://api.shannon-ai.com/v1 Ka ho toba, ka HTTPS.
Mirror e ngotsoeng https://api-encrypted.shannon-ai.com/v1 Ka ho toba, ka HTTPS. Lebitso la bobeli la host bakeng sa API e tšoanang.
Tor (onion service) http://shannonmd773o5vxz75byha5rkea7nzr3srotw46uwythq3pjl6y4cad.onion/v1 Ka Tor client: SOCKS5 proxy, ka default ho 127.0.0.1:9050.
I2P (eepsite) http://acvnvkdea4xaczzjap7chysqqi4kkvp2eorfwkasindzmjpa47da.b32.i2p/v1 Ka I2P router: HTTP proxy, ka default ho 127.0.0.1:4444.
  • SDK ea OpenAI e nka base URL joalo ka ha e bontšitsoe, e nang le /v1. SDK ea Anthropic e e nka ntle le /v1.
  • Ho hlahloba aterese, bala li-header tsa karabo tsa https://api.shannon-ai.com: Onion-Location e nka aterese ea onion mme X-I2P-Location e nka aterese ea I2P. Aterese ea onion e qala ka shannon.

Litsela life tse sebetsang

Tsela e 'ngoe le e 'ngoe ea /v1 e araba ho liaterese tsohle tse nne:

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

GET /v1/models ha e hloke senotlolo, e leng e etsang hore e be teko e potlakileng ea hore proxy ea hau e fihla ho API.

Se tšoanang le se fapaneng

Ntho E tšoana? Lintlha
Litsela, li-field tsa kopo, likarabo, liphoso E tšoana Li tšoana ho aterese e 'ngoe le e 'ngoe. Ha ho tsela e itšoarang ka tsela e fapaneng ho latela lebitso la host.
Senotlolo sa API E tšoana Senotlolo se le seng se sebetsa ho aterese e 'ngoe le e 'ngoe, e le Authorization: Bearer kapa x-api-key. Li-cookie ha li baloe ka mohla ho /v1.
Balance le meeli E tšoana Balance e tšoanang le moeli o tšoanang oa likopo tse 120 ka motsotso. Tsena ka bobeli li baloa ka akhaonte, eseng ka aterese.
Boholo ba kopo E tšoana Ho fihlela ho 32 MiB ka body ea kopo.
Scheme Ea fapana https:// ho clear web le ho mirror. http:// ho liaterese tsa .onion le .b32.i2p, moo marang-rang ka bo ona a sireletsang connection ho tloha qalong ho isa qetellong.
Proxy Ea fapana Ha ho e 'ngoe ho clear web. SOCKS5 proxy bakeng sa Tor, HTTP proxy bakeng sa I2P. Lebitso le tlameha ho rarolloa ke proxy, eseng ke mochini oa hau.
Lebelo Ea fapana Marang-rang ka bobeli a eketsa tieho ho byte e 'ngoe le e 'ngoe. I2P ke eona e liehang ho feta tse peli.

Balance le meeli li hlalositsoe leqepheng la tsona. Meeli le balance

cURL ka Tor

Tsamaisa Tor client mochining oa hau. E fana ka SOCKS5 proxy ho 127.0.0.1:9050. --socks5-hostname e fa proxy eo lebitso la .onion.

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 ka I2P

Tsamaisa I2P router mochining oa hau. E fana ka HTTP proxy ho 127.0.0.1:4444, e amohelang lebitso la .b32.i2p joalo ka ha le le.

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 ea SDK

SDK e hloka liphetoho tse peli: base URL ea marang-rang, le HTTP client e fetang proxy. Ho Python li-SDK ka bobeli tsa semmuso li amohela httpx client. Bakeng sa SOCKS proxy install 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)

Streaming e sebetsa ho marang-rang ka bobeli. Ha stream e bulehile mme model e se na letho la ho romela, API e romela keep-alive, e le hore connection e se shebahale e shoele ho proxy kapa ho client ea hau.

Endpoint Keep-alive ho stream e bulehileng E rometsoe bakeng sa
/v1/chat/completions Mohala oa maikutlo (o qala ka :) ka mor'a metsotsoana e 15 e 'ngoe le e 'ngoe. Li-model tsohle
/v1/messages event: ping, kapa mohala oa maikutlo, ka mor'a metsotsoana e 15 e 'ngoe le e 'ngoe. Li-model tsohle
/v1/responses Mohala oa maikutlo ka mor'a metsotsoana e 15 e 'ngoe le e 'ngoe. Li-model tse hosted tsa open-weight
  • Romela "stream": true. Karabo ea streaming e qala ho fihla hang ha model e ngola, mme keep-alive e bontša hore kopo e ntse e sebetsoa. Karabo e se nang streaming ha e romele letho ho fihlela karabo eohle e loketse.
  • Fa client read timeout e telele. Mehlala e sebelisa metsotsoana e 600. Timeout e khutšoanyane ho feta metsotsoana e 15 e ka felisa stream pakeng tsa li-keep-alive tse peli.
  • Lumella SSE reader ea hau hore e tlole mela ea maikutlo le li-event tsa ping. Li-SDK li se li etsa sena.
  • U se ke ua romela kopo hape hang ha connection e khaoha. Kopo e fihletseng API e tsoela pele ho fihlela qetellong mme e baloa, esita le ha connection e ile.
  • Leka tsela ka GET /v1/models pele. Ha e hloke senotlolo mme e khutlisa lenane le lekhutšoanyane la JSON.

Mathata a connection

Matšoao Lebaka le tokiso
Connection ho 127.0.0.1:9050 kapa 127.0.0.1:4444 e hanoa Ha ho Tor client kapa I2P router e sebetsang mochining oa hau, kapa e mamela port e 'ngoe. Tor Browser e fana ka SOCKS proxy ea eona ho port 9150.
Could not resolve host bakeng sa lebitso la .onion Client e lekile ho rarolla lebitso ka bo eona. Sebelisa --socks5-hostname ho cURL le socks5h:// ho proxy URL, e le hore Tor client e le rarolle.
I2P proxy e araba ka leqephe la eona la phoso Router ha e so fumane aterese. Router e hloka metsotso e seng mekae ka mor'a hore e qale. Leka hape.
401 le Missing authentication Kopo e fihlile ntle le senotlolo. Romela header e tšoanang le ea clear web.

Phoso e 'ngoe le e 'ngoe e tšoana le ea clear web. Diphoso

Senotlolo sa hau ntle le JavaScript

Shannon e boetse e na le webosaete ntle le JavaScript, e fumanehang ho clear web, e le onion service le e le eepsite. Leqephe la eona la /keys le bontša senotlolo sa hau sa API mme le u lumella ho se fetola, kahoo u ka fumana senotlolo ntle le ho tsoa ho Tor kapa I2P. encrypted.shannon-ai.com/keys

Liaterese tsa webosaete eo marang-rang a mararo kaofela li thathamisitsoe mona: Phihlello e ngotsoeng