Endpoint ـە ڕەمزکراوەکان، Tor و I2P

Base URL ـەکان

چوار ناونیشان دەگەنە هەمان API. ئەوە بەکاربهێنە کە لەگەڵ تۆڕەکەت دەگونجێت، بە هەمان کلیلی API و هەمان داواکاری.

• SDK ی OpenAI base URL وەک نیشان دراوە وەردەگرێت، لەگەڵ /v1. SDK ی Anthropic بەبێ /v1 وەریدەگرێت.
• بۆ پشکنینی ناونیشانێک، headers ی وەڵامی https://api.shannon-ai.com بخوێنەرەوە: 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 لەسەر ئامێرەکەت بخەرە کار. proxy ی SOCKS5 لەسەر 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 لەسەر ئامێرەکەت بخەرە کار. proxy ی HTTP لەسەر 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"}]
  }'

Base URL ی SDK

SDK دوو گۆڕانکاری پێویستە: base URL ی تۆڕەکە، و کلاینتێکی HTTP کە بە proxy دا بڕوات. لە Python هەردوو SDK ی فەرمی کلاینتی httpx وەردەگرن. بۆ proxy ی SOCKS، 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 هیچ نانێرێت تا هەموو وەڵامەکە ئامادە دەبێت.
• کاتی خوێندنەوەی درێژ بدە بە کلاینتەکە. نموونەکان 600 چرکە بەکاردەهێنن. timeout ێکی کەمتر لە 15 چرکە دەتوانێت stream ێک لە نێوان دوو keep-alive دا کۆتایی پێبهێنێت.
• وا بکە خوێنەری SSE ـەکەت هێڵەکانی تێبینی و ڕووداوەکانی ping بپەڕێنێت. SDK ـەکان پێشتر ئەمە دەکەن.
• داواکارییەک مەنێرەوە لە ساتی پچڕانی پەیوەندییەکەدا. داواکارییەک کە گەیشتووەتە API تا کۆتایی کار دەکات و هەژمار دەکرێت، کاتێکیش پەیوەندییەکە نەمابێت.
• سەرەتا ڕێگاکە بە GET /v1/models تاقی بکەرەوە. پێویستی بە کلیل نییە و لیستێکی کورتی JSON دەگەڕێنێتەوە.

کێشەکانی پەیوەندی

هەموو هەڵەیەکی دیکە وەک وێبی ئاسایی وایە. Çewtî

کلیلەکەت بەبێ JavaScript

Shannon هەروەها ماڵپەڕێکی بەبێ JavaScript ی هەیە، کە لەسەر وێبی ئاسایی، وەک خزمەتگوزاری onion و وەک eepsite بەردەستە. لاپەڕەی /keys ـەکەی کلیلی API ـەکەت نیشان دەدات و ڕێگەت دەدات بیگۆڕیت، بۆیە دەتوانیت کلیلێک وەربگریت بەبێ دەرچوون لە Tor یان I2P. encrypted.shannon-ai.com/keys

ناونیشانەکانی ئەو ماڵپەڕە لەسەر هەر سێ تۆڕەکە لێرە لیست کراون: دەستپێگەیشتنی ڕەمزکراو