Shannon መተሓላለፊ ይጽዓን ኣሎ...
OpenAI እና Anthropic ዝተማሓዘ የAI API ምስ function calling, web search, structured outputs.
Shannon ናይ OpenAI/Anthropic ተማሓዘ API ንምጀመር ዘድሊ ኩሉ።
https://us-central1-shannonai.cloudfunctions.net/v1/chat/completionsChat Completions API ምስ function calling እና streaming ተጠቀም።
https://us-central1-shannonai.cloudfunctions.net/v1/messagesClaude Messages format ምስ tools እና anthropic-version header።
Authorization: Bearer <api-key>ወይ X-API-Key ምስ anthropic-version ንClaude style calls።
ህዝባዊ ሰነድ - ንcall ቁልፍ ይፈልግStreaming, function calling, structured outputs, web search.
OpenAI እና Anthropic APIs ን drop-in replacement; tools, structured outputs እና built-in web search ይደግፍ።
OpenAI እና Anthropic SDKs ምስ ይሰርሕ። base URL ብቻ ቀይር።
Tools መግለጺ እቲ Shannon ንዘን ይጠርዕ። auto, forced, none መዋቅር ይደግፍ።
Real-time web search ከ citations ጋር። ብራሱ ይገኛል።
JSON mode እና JSON Schema enforcement ን ተመኪእ ውሂብ ምውጻእ።
Automatic function execution loops. ክሳብ 10 iterations ን እያንዳንዱ request።
Server-sent events ን real-time token streaming።
ብሶስተ መደብ ጀምር። Shannon ናይ OpenAI እና Anthropic clients ይታወን።
OpenAI-compatible endpoint ተጠቀም።
https://us-central1-shannonai.cloudfunctions.net/v1/chat/completionsAuthorization header ውስጢ Bearer auth ተጠቀም።
ቋንቋ ምረጽ እና ቁልፍካ ቀይር።
from openai import OpenAIclient = 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)
{
"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
}
}Shannon API ብሰብሳብ ብራውዘር ፈትን። ጥያቄ ኣቐምጥ፣ ኣሰርሕ፣ ውጽኢት ብቅርቡ ርአ።
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.
Pick an endpoint, shape the payload, and run the request to inspect the live output.
{"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 ይሕተቱ።
Authorization: Bearer YOUR_API_KEY
X-API-Key: YOUR_API_KEYanthropic-version: 2023-06-01
Shannon ን ዝተለያዩ ኣጠቃቀም ምክንያታት ዝተሻለ ሞዴላት ይሃብ።
shannon-balanced-grpoBalancedዕለታዊ ስራታት ን ፈጣን እና ውጽኢታዊ ምላሽ
shannon-deep-dapoDeepለምስሕት ችግኝ ዝሓሸ reasoning
shannon-coder-1CoderClaude Code CLI ን call-based quota ተጠናክሮ
Shannon ን ስራ እና መረጋጋጽ ዝተመደቡ tools ኣቕምጥ።
from openai import OpenAIimport jsonclient = OpenAI(api_key="YOUR_API_KEY",base_url="https://us-central1-shannonai.cloudfunctions.net/v1")# Define available tools/functionstools = [{"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 functionif 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}")
{
"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 ክመልስ ኣስገድድ።
from openai import OpenAIclient = OpenAI(api_key="YOUR_API_KEY",base_url="https://us-central1-shannonai.cloudfunctions.net/v1")# Force JSON output with schemaresponse = 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 jsondata = json.loads(response.choices[0].message.content)print(data) # {"name": "John Doe", "age": 30, "occupation": "engineer"}
Server-Sent Events ብ real-time token streaming ን responsive UI ኣብር።
from openai import OpenAIclient = OpenAI(api_key="YOUR_API_KEY",base_url="https://us-central1-shannonai.cloudfunctions.net/v1")# Enable streaming for real-time responsesstream = 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)
Shannon ብራሱ ዝግና የweb_search ስራ ኣለዎ።
from openai import OpenAIclient = 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 informationresponse = client.chat.completions.create(model="shannon-balanced-grpo",messages=[{"role": "user", "content": "What are the latest AI news today?"}],# Optionally, explicitly define web_search tooltools=[{"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
Shannon ናይ Anthropic Messages API format ውን ይደግፍ።
https://us-central1-shannonai.cloudfunctions.net/v1/messagesimport anthropicclient = 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)
OpenAI ወይ Anthropic SDK እንተሆነ ተጠቀም — base URL ብቻ ቀይር።
Shannon መደበኛ HTTP status codes ይጠቀም እና ዝርዝር ሓጋይ መልእኽቲ ይህብ።
{
"error": {
"message": "Invalid API key provided",
"type": "authentication_error",
"code": "invalid_api_key"
}
}Shannon API ዝመጹ ዝርዝር ምሓደስ እና ምሻል።
API ቁልፍካ ርከብ እና ሎሚ Shannon AI ምስ ጀምር።