کوډ شوي، Tor & I2P endpoints

Base URLs

څلور پتې هماغه API ته لار پیدا کوي. هغه یې وکاروئ چې ستاسو شبکې ته مناسب وي، د همدې API کیلي او همدې غوښتنو سره.

• OpenAI SDK base URL هماغسې اخلي لکه ښودل شوی، د /v1 سره. Anthropic SDK یې پرته له /v1 اخلي.
• د پتې د چک لپاره، د https://api.shannon-ai.com د ځواب headers ولولئ: Onion-Location د onion پته لري او X-I2P-Location د I2P پته. د onion پته په shannon پیلیږي.

کومې لارې کار کوي

هره /v1 لار په ټولو څلورو پتو ځواب ورکوي:

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

GET /v1/models کیلي ته اړتیا نه لري، چې دا د دې چټک ازموینه جوړوي چې ستاسو proxy API ته رسیږي.

څه یو شان دي او څه توپیر لري

بیلانس او حدونه په خپله جلا پاڼه کې بیان شوي. حدونه او بیلانس

cURL د Tor له لارې

په خپل ماشین کې Tor کلاینټ چلوئ. دا په 127.0.0.1:9050 SOCKS5 proxy وړاندې کوي. --socks5-hostname د .onion نوم دې proxy ته سپاري.

# 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 د I2P له لارې

په خپل ماشین کې I2P router چلوئ. دا په 127.0.0.1:4444 HTTP proxy وړاندې کوي، چې .b32.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"}]
  }'

د SDK base URL

SDK دوه بدلونونو ته اړتیا لري: د شبکې base URL، او HTTP کلاینټ چې د proxy له لارې ځي. په Python کې دواړه رسمي SDKs httpx کلاینټ مني. د SOCKS proxy لپاره 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 او keep-alive

Streaming په دواړو شبکو کې کار کوي. پداسې حال کې چې stream پرانیستی وي او ماډل لا هیڅ نه لري چې ولیږي، API keep-alive لیږي، نو اړیکه proxy ته یا ستاسو کلاینټ ته مړه نه ښکاري.

• "stream": true ولیږئ. stream شوی ځواب هماغه شیبه رارسیدل پیلوي چې ماډل لیکي، او keep-alive ښيي چې غوښتنه لا هم پروسس کیږي. غیر-stream شوی ځواب تر هغه څه نه لیږي چې ټول ځواب چمتو شي.
• کلاینټ ته اوږد لوستلو timeout ورکړئ. نمونې 600 ثانیې کاروي. له 15 ثانیو لنډ timeout کولی شي stream د دوو keep-alives ترمنځ پای ته ورسوي.
• خپل SSE لوستونکی ته اجازه ورکړئ چې تبصرې کرښې او ping رخدادونه پریږدي. SDKs دا لا دمخه کوي.
• غوښتنه هغه شیبه بیا مه لیږئ کله چې اړیکه ماته شي. هغه غوښتنه چې API ته رسیدلې تر پایه چلیږي او شمیرل کیږي، هم کله چې اړیکه نشته.
• لار لومړی د GET /v1/models سره وازمایئ. کیلي ته اړتیا نه لري او لنډ JSON لیست بیرته ورکوي.

د اړیکې ستونزې

هره بله تېروتنه هماغه ده لکه په کلیر ویب کې. د تېروتنې اداره کول

ستاسو کیلي پرته له JavaScript

Shannon یوه ویب پاڼه هم لري پرته له JavaScript، چې په کلیر ویب کې، د onion service په توګه او د eepsite په توګه لاسرسی وړ ده. د هغې /keys پاڼه ستاسو API کیلي ښيي او اجازه درکوي چې یې بدله کړئ، نو تاسو کولی شئ کیلي ترلاسه کړئ پرته له دې چې Tor یا I2P پریږدئ. encrypted.shannon-ai.com/keys

د هغې ویب پاڼې پتې په ټولو درېیو شبکو کې دلته لیست شوي: کوډ شوی لاسرسی