د SHANNON A.I. لوګو
SHANNONA.I.
خبرېقیمتAPIڅیړنهشرکتPentest AIStartup Boost

د Shannon انٹرفیس بارول...

حالت کتل کېږي...
د API لاسوندونه

Shannon API

د OpenAI او Anthropic سره سازګار AI API چې دنده غږونه، وېب لټون او جوړښت لرونکي پایلې لري.

خپل API کیلي واخلئPlayground وازمویئV2
لاسوندونه
  • لنډیز
  • وړتیاوې
  • چټک پیل
  • API پلیګراونډنوی
  • اعتبار سنجونه
  • موډلونه
  • دندې غږول
  • جوړښتي پایلې
  • سټریمینګ
  • وېب لټون
  • Anthropic
  • SDKs
  • تېروتنې
  • د بدلونونو لاګ

Shannon AI API Documentation

لنډیز

عامه اسناد

هر څه چې د Shannon د OpenAI او Anthropic سره سازګار API سره د خپرولو لپاره اړتیا لرئ.

URLOpenAI‑سازګار
https://us-central1-shannonai.cloudfunctions.net/v1/chat/completions

د فنکشن کال او سټریمینګ سره Chat Completions API وکاروئ.

URLAnthropic‑سازګار
https://us-central1-shannonai.cloudfunctions.net/v1/messages

Claude Messages بڼه د وسایلو او anthropic-version سرلیک سره.

سرلیکونهتصدیق
Authorization: Bearer <api-key>

یا د Claude‑سټایل غوښتنو لپاره X-API-Key د anthropic-version سره.

لاسرسیحالت
عامه اسناد - د زنګ لپاره کیلي اړینه ده

سټریمینګ، فنکشن کالنګ، جوړښت لرونکي پایلې، وېب لټون.

د لانچ چک لېست
  • ✓
    خپل SDK Shannon ته وګرځوئ
    baseURL د پورته OpenAI یا Anthropic endpoints ته وټاکئ.
    سیټ اپ
  • ✓
    خپل API کیلي نښلوئ
    د OpenAI زنګونو لپاره Bearer ټوکنونه یا X-API-Key + anthropic-version وکاروئ.
    امنیت
  • ✓
    وسایل او structured outputs فعال کړئ
    OpenAI tools/functions، JSON schema، او built‑in web_search ملاتړ کوي.
    وړتیاوې
  • ✓
    کارېدنه تعقیب کړئ
    کله چې ساین اِن اوسئ، په دې پاڼه کې د ټوکن او لټون لګښت وګورئ.
    انالېټکس

وړتیاوې

OpenAI + Anthropic

د OpenAI او Anthropic API ګانو لپاره drop‑in بدیل، د اوزارونو، جوړښتي پایلو او جوړ شوي وېب لټون ملاتړ سره.

ډراپ‑اِن بدیل

سازګار

OpenAI او Anthropic SDKs سره کار کوي. یوازې base URL بدل کړئ.

فنکشن کالنګ

وسایل

وسایل تعریف کړئ، Shannon یې زنګ وهي. auto، forced او none حالتونه ملاتړ.

جوړ‑سره وېب لټون

لټون

د سرچینو حوالو سره رېل‑ټایم وېب لټون. په اوتومات ډول موجود.

جوړښت لرونکي پایلې

JSON

د باور وړ ډاټا لپاره JSON حالت او JSON Schema پلي کول.

ملټي‑ټرن وسایل

ایجنتیک

اتومات فنکشن اجرا لوپونه. په هره غوښتنه کې تر 10 تکرارونو.

سټریمینګ

چټک

د رېل‑ټایم ټوکن سټریمینګ لپاره Server‑Sent Events.

چټک پیل

۵ دقیقې

په درې ګامونو کې پیل وکړئ. Shannon د OpenAI او Anthropic کلاینټونه انعکاسوي.

1

خپل base URL وټاکئ

OpenAI‑سازګار endpoint وکاروئ.

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

خپل API کیلي اضافه کړئ

په Authorization سرلیک کې 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)

د ځواب بڼه

بریالی ځواب
{
  "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 پلیګراونډ

نوی

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 ټولې غوښتنې د Shannon API کیلي سره تصدیق غواړي.

OpenAI بڼه (سپارښت شوې)

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

د پېچلو ستونزو لپاره پرمختللې ریزننګ

سیاق128K
د دې لپاره غورهتحلیل، څېړنه، پېچلي کارونه
shannon-coder-1Coder

د Claude Code CLI لپاره د زنګ‑پر‑بنسټ کوټې سره غوره شوی

سیاق128K
د دې لپاره غورهکوډ جوړول، د وسیلو کارول، CLI یوځای کول
د زنګ پر بنسټ کوټه

دندې غږول

هغه اوزارونه تعریف کړئ چې Shannon یې د عمل ترسره کولو یا معلوماتو ترلاسه کولو لپاره غږولی شي.

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"ماډل پرېکړه کوي چې فنکشن کال کړي که نه (ډیفالټ)
"none"د دې غوښتنې لپاره فنکشن کالنګ بند کړئ
{"type": "function", "function": {"name": "..."}}یوه ځانګړې فنکشن کال جبري کړئ

د فنکشن کال ځواب

کله چې ماډل فنکشن کال کوي
{
  "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 دې مجبور کړئ چې ستاسو له سکیمې سره سم معتبر 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"}

د ځواب بڼې اختیارونه

{"type": "json_object"}سم JSON آوټپټ جبري کړئ (بې له ځانګړي سکیمه)
{"type": "json_schema", "json_schema": {...}}ستاسو دقیق سکیمه سره سم آوټپټ جبري کړئ

سټریمینګ

د ځواب‌ویوونکي UI لپاره د Server‑Sent Events له لارې ریښتیني‑وخت ټوکن سټریمینګ فعال کړئ.

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)
لارښوونه: سټریمینګ ځوابونه د Server‑Sent Events په توګه راځي. هر چنګ کې د جزوي منځپانګې ډیلټا وي.

وېب لټون

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
پرو ټپ: د وېب لټون پایلې حوالې لري. Shannon به په اوتومات ډول سرچینې Cite کړي.

Anthropic

Shannon د 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)
اړین سرلیک: Anthropic بڼه لپاره anthropic-version: 2023-06-01 اړینه ده.

SDKs

سازګار

هر OpenAI یا Anthropic SDK وکاروئ — یوازې base URL بدل کړئ.

OpenAI‑سازګار SDKs

Python

رسمي OpenAI Python SDK - له Shannon سره کار کوي

pip install openai
ډاکس وګورئ
JavaScript / TypeScript

رسمي OpenAI Node.js SDK - له Shannon سره کار کوي

npm install openai
ډاکس وګورئ
Go

د OpenAI‑سازګار APIs لپاره د ټولنې Go کلاینټ

go get github.com/sashabaranov/go-openai
ډاکس وګورئ
Ruby

د OpenAI‑سازګار APIs لپاره د ټولنې Ruby کلاینټ

gem install ruby-openai
ډاکس وګورئ
PHP

د OpenAI‑سازګار APIs لپاره د ټولنې PHP کلاینټ

composer require openai-php/client
ډاکس وګورئ
Rust

د OpenAI‑سازګار APIs لپاره Async Rust کلاینټ

cargo add async-openai
ډاکس وګورئ

Anthropic‑سازګار SDKs

Python (Anthropic)

رسمي Anthropic Python SDK - له Shannon سره کار کوي

pip install anthropic
ډاکس وګورئ
TypeScript (Anthropic)

رسمي Anthropic TypeScript SDK - له Shannon سره کار کوي

npm install @anthropic-ai/sdk
ډاکس وګورئ

تېروتنې

Shannon معیاري HTTP حالت کوډونه کاروي او تفصیلي خطا پیغامونه بېرته ورکوي.

400ناسمه غوښتنهناسمه د غوښتنې بڼه یا پارامیټرونه
401نه مجازناسمه یا ورک API کیلي
402کوټه تېره شوهد ټوکن یا لټون کوټه تېره شوه
429Rate limitډېرې غوښتنې، لږ ورو شئ
500سرور تېروتنهداخلي تېروتنه، وروسته بیا هڅه وکړئ

د تېروتنې ځواب بڼه

د تېروتنې ځواب
{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

د بدلونونو لاګ

د Shannon API لپاره وروستي تازه‌کاري او ښه‌والی.

v2.1.0
2025-01-03
  • نوید Claude Code CLI ادغام لپاره shannon-coder-1 ماډل اضافه شو
  • نوید Coder ماډل لپاره د زنګ‑پر‑بنسټ کوټه سیسټم
  • ښه شوید فنکشن کالنګ باورمنتیا ښه شوه
v2.0.0
2024-12-15
  • نویAnthropic Messages API سازګاري اضافه شوه
  • نویملټي‑ټرن وسیلو اجرا (تر 10 تکرارونو)
  • نویJSON Schema ځواب بڼه ملاتړ
  • ښه شوید ښه حوالو سره وېب لټون ښه شو
v1.5.0
2024-11-20
  • نوید پېچلي ریزننګ لپاره shannon-deep-dapo ماډل اضافه شو
  • نویBuilt‑in web_search فنکشن
  • ښه شوید سټریمینګ ځوابونو ځنډ کم شو
v1.0.0
2024-10-01
  • نویابتدايي API خپرونه
  • نویOpenAI‑سازګار chat completions endpoint
  • نویفنکشن کالنګ ملاتړ
  • نوید Server‑Sent Events له لارې سټریمینګ

د جوړولو لپاره چمتو?

خپل API کیلي واخلئ او نن له Shannon AI سره جوړول پیل کړئ.

API کیلي جوړوللاسوندونه وګورئ