Encrypted, Tor & I2P endpoints

Base URLs

ኣርባዕተ ኣድራሻታት ናብ ሓደ API የብጽሑ። እቲ ምስ መርበብካ ዝሰማማዕ ተጠቐም፣ ምስ ሓደ API key ከምኡውን ሓደ ጠለባት።

• OpenAI SDK እቲ base URL ከም ዝተርኣየ፣ ምስ /v1 ይወስድ። Anthropic SDK ብዘይ /v1 ይወስድ።
• ኣድራሻ ንምርግጋጽ፣ headers ናይ ምላሽ ናይ https://api.shannon-ai.com ኣንብብ፦ Onion-Location ኣድራሻ onion ይሕዝ ከምኡውን X-I2P-Location ኣድራሻ I2P። ኣድራሻ onion ብ shannon ይጅምር።

ኣየኖት routes ይሰርሑ

ነፍሲ ወከፍ route /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 client ኣብ ማሽንካ ኣስርሕ። SOCKS5 proxy ኣብ 127.0.0.1:9050 የቕርብ። --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

Router I2P ኣብ ማሽንካ ኣስርሕ። ንሱ HTTP proxy ኣብ 127.0.0.1:4444 የቕርብ፣ ንስም .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 client ብ proxy ዝሓልፍ። ኣብ Python ክልቲኦም ወግዓውያን SDKs client 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 ወይ ንclient ናትካ ከም ዝሞተ ኣይመስልን።

• "stream": true ልኣኽ። ዝውሕዝ ምላሽ እቲ ሞዴል ምስ ጸሓፈ ብቕልጡፍ ክበጽሕ ይጅምር፣ እቲ keep-alive ድማ እቲ ጠለብ ገና ይሰርሕ ከም ዘሎ ይሕብር። ዘይውሕዝ ምላሽ ክሳብ ምሉእ መልሲ ዝድሉ ዋላ ሓንቲ ኣይልእክን።
• ን client ነዊሕ read timeout ሃቦ። እቶም ኣብነታት 600 ሰከንድታት ይጥቀሙ። timeout ካብ 15 ሰከንድታት ዝሓጸረ stream ኣብ መንጎ ክልተ keep-alives ክቋርጽ ይኽእል።
• SSE reader ናትካ መስመራት ርእይቶ ከምኡውን events ping ይሕልፍ። እቶም SDKs ድሮ ይገብርዎ።
• ርክብ ምስ ተቐርጸ ብቕጽበት እቲ ጠለብ ደጊምካ ኣይትልእኽ። ናብ API ዝበጽሐ ጠለብ ክሳብ መወዳእታኡ ይሰርሕ ከምኡውን ይቑጸር፣ ርክብ ምስ ጠፍአ እውን።
• እቲ መገዲ ቅድም ብ GET /v1/models ፈትኖ። ቁልፊ ኣየድልዮን ከምኡውን ሓጺር ዝርዝር JSON ይመልስ።

ጸገማት ርክብ

ኩሉ ካልእ ጌጋ ከም ኣብ clear web ተመሳሳሊ እዩ። ሓጋይ ኣስተዳደር

ቁልፍካ ብዘይ JavaScript

Shannon website ብዘይ JavaScript እውን ኣለዎ፣ ኣብ clear web፣ ከም onion service ከምኡውን ከም eepsite ይርከብ። ገጽ /keys ናቱ API key ናትካ የርኢ ከምኡውን ክትቅይሮ የኽእለካ፣ ስለዚ ካብ Tor ወይ I2P ከይወጻእካ ቁልፊ ክትረክብ ትኽእል። encrypted.shannon-ai.com/keys

ኣድራሻታት ናይዚ website ኣብ ኩሎም ሰለስተ መርበባት ኣብዚ ተዘርዚሮም ኣለዉ፦ Encrypted access