SHANNON A.I. ሎጎ
SHANNONA.I.
ቻትዋጋAPIምርምርኩባንያPentest AIStartup Boost

Shannon መተሓላለፊ ይጽዓን ኣሎ...

ሁነታ ይፈትሹ...
API ሰነድ

Shannon API

OpenAI እና Anthropic ዝተማሓዘ የAI API ምስ function calling, web search, structured outputs.

API ቁልፍ ርከብPlayground ፈትንV2
ሰነድ
  • መግለጺ
  • ክእለታት
  • ፈጣን መጀመር
  • API Playgroundሓድሽ
  • ማረጋገጫ
  • ሞዴላት
  • ግብር ጥሪ
  • የተዋቀረ ውጤት
  • ስትሪም
  • የድር ፍለጋ
  • Anthropic
  • SDKዎች
  • ሓጋይ ኣስተዳደር
  • የለውጥ መዝገብ

Shannon AI API Documentation

መግለጺ

ህዝባዊ ሰነድ

Shannon ናይ OpenAI/Anthropic ተማሓዘ API ንምጀመር ዘድሊ ኩሉ።

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

Chat Completions API ምስ function calling እና streaming ተጠቀም።

URLAnthropic-Compatible
https://us-central1-shannonai.cloudfunctions.net/v1/messages

Claude Messages format ምስ tools እና anthropic-version header።

HTTPማረጋገጫ
Authorization: Bearer <api-key>

ወይ X-API-Key ምስ anthropic-version ንClaude style calls።

ምውላድሁነታ
ህዝባዊ ሰነድ - ንcall ቁልፍ ይፈልግ

Streaming, function calling, structured outputs, web search.

ዝርዝር ምጀመር
  • ✓
    SDK ናብ Shannon ኣመራ
    baseURL ናብ OpenAI ወይ Anthropic endpoints ኣብ ላዕሊ ምድላይ ስብስብ።
    ማስተካከል
  • ✓
    API ቁልፍካ ኣገጽ
    OpenAI calls ን Bearer token ወይ X-API-Key + anthropic-version ተጠቀም።
    ደህንነት
  • ✓
    Tools እና structured outputs ኣብር
    OpenAI tools/functions, JSON schema እና built-in web_search ይደግፍ።
    ክእለት
  • ✓
    ኣጠቃቀም ተከታተል
    እተኾን እንከሎ ኣብዚ ገጽ የtoken እና search ኣጠቃቀም ርአ።
    ትንተና

ክእለታት

OpenAI + Anthropic

OpenAI እና Anthropic APIs ን drop-in replacement; tools, structured outputs እና built-in web search ይደግፍ።

Drop-in Replacement

Compatible

OpenAI እና Anthropic SDKs ምስ ይሰርሕ። base URL ብቻ ቀይር።

ጥራይ ፋንክሽን

Tools

Tools መግለጺ እቲ Shannon ንዘን ይጠርዕ። auto, forced, none መዋቅር ይደግፍ።

የድር ፍለጋ

ፈልጥ

Real-time web search ከ citations ጋር። ብራሱ ይገኛል።

የተዋቀረ ውጤት

JSON

JSON mode እና JSON Schema enforcement ን ተመኪእ ውሂብ ምውጻእ።

Multi-turn Tools

Agentic

Automatic function execution loops. ክሳብ 10 iterations ን እያንዳንዱ request።

ስትሪም

Fast

Server-sent events ን real-time token streaming።

ፈጣን መጀመር

5 ደቒቃ

ብሶስተ መደብ ጀምር። Shannon ናይ OpenAI እና Anthropic clients ይታወን።

1

Base URL ኣቕምጥ

OpenAI-compatible endpoint ተጠቀም።

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

API ቁልፍ ጨምር

Authorization header ውስጢ Bearer auth ተጠቀም።

3

ፈለም መልእኽቲ ስደድ

ቋንቋ ምረጽ እና ቁልፍካ ቀይር።

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)

Response format

Success Response
{
  "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

ሓድሽ

Shannon API ብሰብሳብ ብራውዘር ፈትን። ጥያቄ ኣቐምጥ፣ ኣሰርሕ፣ ውጽኢት ብቅርቡ ርአ።

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
}

ማረጋገጫ

API requests ሁሉ ብ Shannon API key ይሕተቱ።

OpenAI Format (Recommended)

HTTP
Authorization: Bearer YOUR_API_KEY

Anthropic

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

ሞዴላት

Shannon ን ዝተለያዩ ኣጠቃቀም ምክንያታት ዝተሻለ ሞዴላት ይሃብ።

shannon-balanced-grpoBalanced

ዕለታዊ ስራታት ን ፈጣን እና ውጽኢታዊ ምላሽ

ኣውድ128K
ን ድሕነት ሰብ ሞያ ዝተሃንጸጫት, Q&A, ይዘት ፍጠር
shannon-deep-dapoDeep

ለምስሕት ችግኝ ዝሓሸ reasoning

ኣውድ128K
ን ድሕነት ሰብ ሞያ ዝተሃንጸትንተና, ምርምር, ዝሓሸ ስራታት
shannon-coder-1Coder

Claude Code CLI ን call-based quota ተጠናክሮ

ኣውድ128K
ን ድሕነት ሰብ ሞያ ዝተሃንጸኮድ ፍጠር, ኣገልግሎት tools, CLI integration
Call-based quota

ግብር ጥሪ

Shannon ን ስራ እና መረጋጋጽ ዝተመደቡ tools ኣቕምጥ።

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}")

ግብር ጥሪ

"auto"ሞዴል ይውስን እንትጠርዕ ወይ እንተዘይጠርዕ (default)
"none"ንዚ request function calling ኣጥፍ
{"type": "function", "function": {"name": "..."}}ነቲ ስውር function call ኣስገድድ

Response format

ሞዴል 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"
    }
  ]
}

የተዋቀረ ውጤት

Shannon ን schema ዘይትርክብ ትክክለኛ JSON ክመልስ ኣስገድድ።

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"}

Response format

{"type": "json_object"}Valid JSON output ኣስገድድ (ብዘይ ስኬማ)
{"type": "json_schema", "json_schema": {...}}ስኬማኻ ዝሰማማ output ኣስገድድ

ስትሪም

Server-Sent Events ብ real-time token streaming ን responsive UI ኣብር።

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)
ምክር: Streaming responses ኣብ Server-Sent Events ይመጽእ። ሓደ ቁራጭ ክፍሊ ዝተያዘ delta ይሓዝ።

የድር ፍለጋ

Shannon ብራሱ ዝግና የweb_search ስራ ኣለዎ።

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
ምኽሪ: Web search ውጽኢት ምንጮች ይህልዉ። Shannon ራሱ ምንጮች ይጥርዕ።

Anthropic

Shannon ናይ Anthropic Messages API format ውን ይደግፍ።

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)
Required: Anthropic format anthropic-version: 2023-06-01 ይፈልግ።

SDKዎች

Compatible

OpenAI ወይ Anthropic SDK እንተሆነ ተጠቀም — base URL ብቻ ቀይር።

OpenAI-Compatible SDKs

Python

Official OpenAI Python SDK — Shannon ምስ ይሰርሕ

pip install openai
ሰነድ ርአ
JavaScript / TypeScript

Official OpenAI Node.js SDK — Shannon ምስ ይሰርሕ

npm install openai
ሰነድ ርአ
Go

OpenAI-compatible API ን community Go client

go get github.com/sashabaranov/go-openai
ሰነድ ርአ
Ruby

OpenAI-compatible API ን community Ruby client

gem install ruby-openai
ሰነድ ርአ
PHP

OpenAI-compatible API ን community PHP client

composer require openai-php/client
ሰነድ ርአ
Rust

OpenAI-compatible API ን Async Rust client

cargo add async-openai
ሰነድ ርአ

Anthropic-Compatible SDKs

Python (Anthropic)

Official Anthropic Python SDK — Shannon ምስ ይሰርሕ

pip install anthropic
ሰነድ ርአ
TypeScript (Anthropic)

Official Anthropic TypeScript SDK — Shannon ምስ ይሰርሕ

npm install @anthropic-ai/sdk
ሰነድ ርአ

ሓጋይ ኣስተዳደር

Shannon መደበኛ HTTP status codes ይጠቀም እና ዝርዝር ሓጋይ መልእኽቲ ይህብ።

400Bad Requestፎርማት ጥያቄ ወይ ፓራሜትራት ኣይትክክልን
401UnauthorizedAPI ቁልፍ ኣይትክክልን ወይ የለን
402Quota ExceededToken ወይ search quota ተጸንሐ
429Rate Limitedብዙሕ ጥያቄዎች, ተንስአ
500Server Errorውስጣዊ ሓጋይ, ቀጺል ሞክር

Error Response Format

Error Response
{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

የለውጥ መዝገብ

Shannon API ዝመጹ ዝርዝር ምሓደስ እና ምሻል።

v2.1.0
2025-01-03
  • ሓድሽshannon-coder-1 ሞዴል ን Claude Code CLI integration ተጨመረ
  • ሓድሽCoder ሞዴል ን call-based quota ስርዓት
  • ተሻሽለFunction calling ዕምነት ተሻሽለ
v2.0.0
2024-12-15
  • ሓድሽAnthropic Messages API compatibility ተጨመረ
  • ሓድሽMulti-turn tool execution (ክሳብ 10 iterations)
  • ሓድሽJSON Schema response format ድጋፍ
  • ተሻሽለWeb search ብምሻል እና citations
v1.5.0
2024-11-20
  • ሓድሽshannon-deep-dapo ሞዴል ን ጥራይ reasoning ተጨመረ
  • ሓድሽBuilt-in web_search function
  • ተሻሽለStreaming responses latency ተቐንሰ
v1.0.0
2024-10-01
  • ሓድሽAPI መጀመሪ ልቀት
  • ሓድሽOpenAI-compatible chat completions endpoint
  • ሓድሽFunction calling support
  • ሓድሽStreaming ብ Server-Sent Events

ብኽብረት ንምህዳስ ዝተዘጋጅካ?

API ቁልፍካ ርከብ እና ሎሚ Shannon AI ምስ ጀምር።

API ቁልፍ ርከብዋጋ ርአ