ILogo ye-SHANNON A.I.
SHANNONA.I.
IncokoAmaxabisoAPIUphandoInkampaniPentest AIStartup Boost

Ilayisha ujongano lwe-Shannon...

Kujongwa imeko...
Amaxwebhu e-API

Shannon API

AI API ehambelanayo ne‑OpenAI ne‑Anthropic, enezimemo zomsebenzi, ukukhangela kwiwebhu, kunye nemveliso ehleliweyo.

Fumana isitshixo sakho se-APIZama i-PlaygroundV2
Amaxwebhu
  • Isishwankathelo
  • Amandla
  • Ukuqalisa ngokukhawuleza
  • API PlaygroundEntsha
  • Ukuqinisekiswa
  • Iimodeli
  • Ukubiza umsebenzi
  • Imveliso ehleliweyo
  • Ukusasaza
  • Ukukhangela kwiwebhu
  • Anthropic
  • SDKs
  • Iimpazamo
  • Ilogi yotshintsho

Shannon AI API Documentation

Isishwankathelo

Amaxwebhu kawonke‑wonke

Konke okufunekayo ukuze ukhuphe usebenzisa i‑API kaShannon ehambelana ne‑OpenAI ne‑Anthropic.

URLIyahambelana neOpenAI
https://us-central1-shannonai.cloudfunctions.net/v1/chat/completions

Sebenzisa Chat Completions API enefunction calling kunye ne streaming.

URLIyahambelana neAnthropic
https://us-central1-shannonai.cloudfunctions.net/v1/messages

Claude Messages format enezixhobo kunye ne anthropic-version header.

HTTPUqinisekiso
Authorization: Bearer <api-key>

Okanye X-API-Key ene anthropic-version ye Claude‑style calls.

UfikeleloImeko
Amaxwebhu kawonke‑wonke - isitshixo siyafuneka

Streaming, function calling, structured outputs, web search.

Uluhlu lokuqalisa
  • ✓
    Yalatha i‑SDK yakho kuShannon
    Seta baseURL kwi OpenAI okanye Anthropic endpoints ezingentla.
    Setup
  • ✓
    Ncamathisela API key yakho
    Sebenzisa Bearer tokens kwi OpenAI calls okanye X-API-Key + anthropic-version.
    Ukhuseleko
  • ✓
    Vula tools & structured outputs
    Ixhasa OpenAI tools/functions, JSON schema, kunye ne built‑in web_search.
    Amandla
  • ✓
    Landela ukusetyenziswa
    Xa ungene, bona ukusetyenziswa kwe token kunye ne search kweli phepha.
    Uhlalutyo

Amandla

OpenAI + Anthropic

I‑drop‑in replacement ye‑OpenAI ne‑Anthropic APIs enenkxaso yezixhobo, imveliso ehleliweyo, kunye nokukhangela kwiwebhu okwakhelwe ngaphakathi.

Drop‑in Replacement

Iyahambelana

Isebenza neOpenAI neAnthropic SDKs. Tshintsha base URL kuphela.

Ukubiza umsebenzi

Izixhobo

Chaza tools, Shannon uya kuzibiza. Ixhasa auto, forced, none modes.

Built‑in Web Search

Ukukhangela

Web search ngexesha‑lenyani ene citations. Iyafumaneka ngokuzenzekelayo.

Iziphumo eziyilwe

JSON

JSON mode kunye ne JSON Schema enforcement yokutsala idatha ethembekileyo.

Multi‑turn Tools

Agentic

Automatic function execution loops. Ukuya kuthi ga ku 10 iterations ngesicelo.

Ukusasaza

Khawuleza

Server‑Sent Events yokuhambisa iitoken ngexesha‑lenyani.

Ukuqalisa ngokukhawuleza

imizuzu 5

Qalisa ngamanyathelo amathathu. Shannon ulinganisa abathengi be‑OpenAI ne‑Anthropic.

1

Seta base URL yakho

Sebenzisa OpenAI‑compatible endpoint.

https://us-central1-shannonai.cloudfunctions.net/v1/chat/completions
2

Yongeza API key yakho

Sebenzisa Bearer auth kwi Authorization header.

3

Thumela umyalezo wakho wokuqala

Khetha ulwimi uze ufake isitshixo sakho.

Python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://us-central1-shannonai.cloudfunctions.net/v1"
)
response = client.chat.completions.create(
model="shannon-balanced-grpo",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello, Shannon!"}
],
max_tokens=1024
)
print(response.choices[0].message.content)

Ifomathi yempendulo

Impendulo ephumeleleyo
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "shannon-balanced-grpo",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! I'm Shannon, your AI assistant. How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 18,
    "total_tokens": 43
  }
}

API Playground

Entsha

Vavanya Shannon API ngqo kwisikhangeli sakho. Yakha isicelo, siqhube, uze ubone impendulo ngexesha‑lenyani.

Claude-style API studio

One polished workbench for every public endpoint.

Switch between Chat Completions, Responses, and Messages without changing pages. The request body, auth header, stream parser, and SDK snippets all follow the selected protocol.

Endpoints3
ThemeCrail / Pampas
Latest response IDNot captured yet
Composer

Chat Completions

Live response

/v1/chat/completions

Chat Completions Idle 0 SSE events No reasoning block
response_idWaiting for a response...
Ready to test.

Pick an endpoint, shape the payload, and run the request to inspect the live output.

0
SDK snippets

Keep the request, headers, and client syntax aligned with the selected endpoint.

JSON
{
"model": "shannon-balanced-grpo",
"messages": [
{
"role": "system",
"content": "You are Shannon. Answer crisply, commercially, and with strong structure."
},
{
"role": "user",
"content": "Outline a clean launch plan for a new AI API aimed at startup founders."
}
],
"max_tokens": 1024,
"temperature": 0.7,
"stream": true
}

Ukuqinisekiswa

Zonke izicelo ze‑API zifuna ukuqinisekiswa nge‑Shannon API key yakho.

OpenAI format (kucetyiswa)

HTTP
Authorization: Bearer YOUR_API_KEY

Anthropic format

HTTP
X-API-Key: YOUR_API_KEY
anthropic-version: 2023-06-01

Iimodeli

Shannon unikezela ngeemodeli ezininzi ezilungiselelwe iimeko zokusetyenziswa ezahlukeneyo.

shannon-balanced-grpoBalanced

Iimpendulo ezikhawulezayo nezisebenzayo kwemihla ngemihla

Konteksti128K
Eyona ilungileyoChat, Q&A, Ukuvelisa Umxholo
shannon-deep-dapoDeep

Reasoning ephambili kwiingxaki ezinzima

Konteksti128K
Eyona ilungileyoUhlalutyo, Uphando, Imisebenzi Enzima
shannon-coder-1Coder

Yenzelwe Claude Code CLI nge call‑based quota

Konteksti128K
Eyona ilungileyoUkuvelisa Ikhowudi, Ukusetyenziswa kweTools, CLI Integration
Call‑based quota

Ukubiza umsebenzi

Chaza izixhobo uShannon angazibiza ukwenza izenzo okanye ukufumana ulwazi.

Python
from openai import OpenAI
import json
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://us-central1-shannonai.cloudfunctions.net/v1"
)
# Define available tools/functions
tools = [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a location",
"parameters": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "City name, e.g., 'Tokyo'"
},
"unit": {
"type": "string",
"enum": ["celsius", "fahrenheit"]
}
},
"required": ["location"]
}
}
}
]
response = client.chat.completions.create(
model="shannon-balanced-grpo",
messages=[{"role": "user", "content": "What's the weather in Tokyo?"}],
tools=tools,
tool_choice="auto"
)
# Check if model wants to call a function
if response.choices[0].message.tool_calls:
tool_call = response.choices[0].message.tool_calls[0]
print(f"Function: {tool_call.function.name}")
print(f"Arguments: {tool_call.function.arguments}")

Iinketho zokukhetha tool

"auto"Imodeli igqiba ukuba ibize function na (default)
"none"Cima function calling kwesi sicelo
{"type": "function", "function": {"name": "..."}}Nyanzelisa function ethile

Impendulo ye Function Call

Xa imodeli ibiza function
{
  "id": "chatcmpl-xyz",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": null,
        "tool_calls": [
          {
            "id": "call_abc123",
            "type": "function",
            "function": {
              "name": "get_weather",
              "arguments": "{\"location\": \"Tokyo\", \"unit\": \"celsius\"}"
            }
          }
        ]
      },
      "finish_reason": "tool_calls"
    }
  ]
}

Imveliso ehleliweyo

Nyanzela uShannon ukuba aphendule nge‑JSON esebenzayo ehambelana nescheme yakho.

Python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://us-central1-shannonai.cloudfunctions.net/v1"
)
# Force JSON output with schema
response = client.chat.completions.create(
model="shannon-balanced-grpo",
messages=[
{"role": "user", "content": "Extract: John Doe, 30 years old, engineer"}
],
response_format={
"type": "json_schema",
"json_schema": {
"name": "person_info",
"schema": {
"type": "object",
"properties": {
"name": {"type": "string"},
"age": {"type": "integer"},
"occupation": {"type": "string"}
},
"required": ["name", "age", "occupation"]
}
}
}
)
import json
data = json.loads(response.choices[0].message.content)
print(data) # {"name": "John Doe", "age": 30, "occupation": "engineer"}

Iinketho zefomathi yempendulo

{"type": "json_object"}Nyanzelisa valid JSON output (ngaphandle kwesikimu esithile)
{"type": "json_schema", "json_schema": {...}}Nyanzelisa output ehambelana nesikimu sakho ngokuchanileyo

Ukusasaza

Vula i‑token streaming yexesha lokwenyani nge‑Server‑Sent Events ukuze i‑UI ibe nomxakatho okhawulezayo.

Python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://us-central1-shannonai.cloudfunctions.net/v1"
)
# Enable streaming for real-time responses
stream = client.chat.completions.create(
model="shannon-balanced-grpo",
messages=[
{"role": "user", "content": "Write a short poem about AI"}
],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Icebiso: Streaming responses ziza njenge Server‑Sent Events. Chunk nganye ine delta enomxholo ongaphelelanga.

Ukukhangela kwiwebhu

Shannon une‑web_search eyakhelwe ngaphakathi ekhoyo ngokuzenzekelayo.

Python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://us-central1-shannonai.cloudfunctions.net/v1"
)
# Web search is automatically available!
# Shannon will use it when needed for current information
response = client.chat.completions.create(
model="shannon-balanced-grpo",
messages=[
{"role": "user", "content": "What are the latest AI news today?"}
],
# Optionally, explicitly define web_search tool
tools=[{
"type": "function",
"function": {
"name": "web_search",
"description": "Search the web for current information",
"parameters": {
"type": "object",
"properties": {
"query": {"type": "string", "description": "Search query"}
},
"required": ["query"]
}
}
}]
)
print(response.choices[0].message.content)
# Response includes sources and citations
Tip: Iziphumo ze web search zine citations. Shannon uya kucaphula imithombo ngokuzenzekelayo.

Anthropic

Shannon uyaxhasa ifomathi ye‑Anthropic Messages API.

https://us-central1-shannonai.cloudfunctions.net/v1/messages
Python
import anthropic
client = anthropic.Anthropic(
api_key="YOUR_API_KEY",
base_url="https://us-central1-shannonai.cloudfunctions.net/messages"
)
response = client.messages.create(
model="shannon-balanced-grpo",
max_tokens=1024,
messages=[
{"role": "user", "content": "Hello, Shannon!"}
],
# Tool use (Anthropic format)
tools=[{
"name": "web_search",
"description": "Search the web",
"input_schema": {
"type": "object",
"properties": {
"query": {"type": "string"}
},
"required": ["query"]
}
}]
)
print(response.content[0].text)
Header efunekayo: Anthropic format ifuna anthropic-version: 2023-06-01.

SDKs

Iyahambelana

Sebenzisa nayiphi na i‑OpenAI okanye i‑Anthropic SDK — tshintsha i‑base URL kuphela.

OpenAI‑Compatible SDKs

Python

Official OpenAI Python SDK - isebenza neShannon

pip install openai
Bona Docs
JavaScript / TypeScript

Official OpenAI Node.js SDK - isebenza neShannon

npm install openai
Bona Docs
Go

Community Go client ye OpenAI‑compatible APIs

go get github.com/sashabaranov/go-openai
Bona Docs
Ruby

Community Ruby client ye OpenAI‑compatible APIs

gem install ruby-openai
Bona Docs
PHP

Community PHP client ye OpenAI‑compatible APIs

composer require openai-php/client
Bona Docs
Rust

Async Rust client ye OpenAI‑compatible APIs

cargo add async-openai
Bona Docs

Anthropic‑Compatible SDKs

Python (Anthropic)

Official Anthropic Python SDK - isebenza neShannon

pip install anthropic
Bona Docs
TypeScript (Anthropic)

Official Anthropic TypeScript SDK - isebenza neShannon

npm install @anthropic-ai/sdk
Bona Docs

Iimpazamo

Shannon usebenzisa ii‑HTTP status codes eziqhelekileyo kwaye ubuyisa imiyalezo yephutha eneenkcukacha.

400Isicelo esingalungangaIfomathi yesicelo okanye iiparamitha ezingalunganga
401AyigunyazwangaAPI key engalunganga okanye engekhoyo
402Quota igqithileToken okanye search quota igqithile
429Rate LimitIzicelo ezininzi, yehla isantya
500Impazamo ye sevaImpazamo yangaphakathi, zama kwakhona

Ifomathi yempendulo yempazamo

Impendulo yempazamo
{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Ilogi yotshintsho

Uhlaziyo lwamva nje kunye neziphuculo ze‑Shannon API.

v2.1.0
2025-01-03
  • EntshaKongezwe shannon-coder-1 model ye Claude Code CLI integration
  • EntshaCall‑based quota system ye Coder model
  • IphuculweUkuthembeka kwe function calling kuphuculwe
v2.0.0
2024-12-15
  • EntshaUkuxhaswa kwe Anthropic Messages API kongeziwe
  • EntshaMulti‑turn tool execution (ukuya kwi 10 iterations)
  • EntshaInkxaso ye JSON Schema response format
  • IphuculweWeb search ephuculwe nge citations ezingcono
v1.5.0
2024-11-20
  • EntshaKongezwe shannon-deep-dapo model ye reasoning enzima
  • EntshaBuilt‑in web_search function
  • IphuculweLatency ye streaming responses iye yehliswa
v1.0.0
2024-10-01
  • EntshaUkukhutshwa kokuqala kwe API
  • EntshaOpenAI‑compatible chat completions endpoint
  • EntshaInkxaso ye function calling
  • EntshaStreaming nge Server‑Sent Events

Ulungile ukwakha?

Fumana i‑API key yakho uze uqale ukwakha nge‑Shannon AI namhlanje.

Yenza isitshixo se-APIJonga amaxwebhu