Endpoint-yo sir-geliyay, Tor & I2P

Base URL-yo

Afar cinwaan ayaa u horseeda isla API-ga. Isticmaal kan shabakaddaada ku habboon, isla furaha API iyo isla codsiyada.

• SDK OpenAI wuxuu qaataa base URL-ka sida lagu muujiyay, /v1 la socda. SDK Anthropic wuxuu qaataa /v1 la'aantiis.
• Si aad cinwaan u hubiso, akhri header-yada jawaabta ee https://api.shannon-ai.com: Onion-Location wuxuu sidaa cinwaanka onion X-I2P-Location-na cinwaanka I2P. Cinwaanka onion wuxuu ku bilaabmaa shannon.

Jidadka shaqeeya

Jid kasta oo /v1 ah wuxuu ka jawaabaa dhammaan afarta cinwaan:

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

GET /v1/models fure ma u baahna, taasoo ka dhigaysa tijaabo degdeg ah oo muujinaysa in proxy-gaagu API-ga gaaro.

Waxa isku mid ah iyo waxa ku kala duwan

Haraagga iyo xadadka waxaa lagu sharaxay bog u gaar ah. Xadad iyo haraag

cURL Tor ahaan

Ku orodsii macmiil Tor mashiinkaaga. Wuxuu bixiyaa SOCKS5 proxy 127.0.0.1:9050. --socks5-hostname wuxuu magaca .onion u gudbiyaa proxy-gaas.

# 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 ahaan

Ku orodsii router I2P mashiinkaaga. Wuxuu bixiyaa HTTP proxy 127.0.0.1:4444, kaas oo magaca .b32.i2p qaata sida uu yahay.

# 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-ka SDK

SDK wuxuu u baahan yahay laba isbeddel: base URL-ka shabakadda, iyo macmiil HTTP oo ka maro proxy-ga. Python labada SDK ee rasmiga ah waxay qaataan macmiil httpx. SOCKS proxy rakib 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 iyo keep-alive isku xirka gaabiska ah

Streaming wuxuu ka shaqeeyaa labada shabakadood. Inta stream furan yahay oo model-ku wali waxba haysan inuu diro, API-gu wuxuu diraa keep-alive, sidaas darteed isku xirku ugama muuqdo proxy ama macmiilkaaga sidii mid dhintay.

• Dir "stream": true. Jawaab stream ah way bilaabmaysaa inay timaado isla marka model-ku qoro, keep-alive-na wuxuu muujiyaa in codsiga la shaqeynayo. Jawaab aan stream ahayn waxba ma diraan ilaa jawaabta oo dhan diyaar tahay.
• Macmiilka sii read timeout dheer. Tusaalayaashu waxay isticmaalaan 600 ilbiriqsi. Timeout ka gaaban 15 ilbiriqsi wuxuu ku dhammayn karaa stream laba keep-alive dhexdooda.
• U daa akhriyaha SSE inuu ka booda xariiqaha faallada iyo events-ka ping. SDK-yadu horeba sidaas yeelaan.
• Ha dib u dirin codsi isla markii isku xirku go'o. Codsi API-ga gaaray wuu ordaa ilaa dhammaadkiisa waana la tiriyaa, xataa marka isku xirku maqan yahay.
• Jidka marka hore ku tijaabi GET /v1/models. Fure ma u baahna wuxuuna soo celiyaa liis JSON ah oo gaaban.

Dhibaatooyin isku xirka

Khalad kasta oo kale wuxuu la mid yahay kan webka cad. Khaladaadka Maareynta

Furahaaga JavaScript la'aan

Shannon sidoo kale wuxuu leeyahay website JavaScript la'aan ah, oo laga gaari karo webka cad, sida onion service iyo sida eepsite. Bogga /keys wuxuu muujiyaa furahaaga API wuxuuna kuu ogolaadaa inaad beddesho, sidaas darteed fure ayaad heli kartaa adigoon ka bixin Tor ama I2P. encrypted.shannon-ai.com/keys

Cinwaannada website-kaas ee saddexda shabakadood halkan ayaa lagu liis garaynayaa: Gelid sir-geliyay