Logoya SHANNON A.I.
SHANNONA.I.
ChatBihaAPILêkolînPargîdanîPentest AIStartup Boost

Navrûya Shannon tê barkirin...

Rewş tê kontrol kirin...
Belgeya API

Shannon API

APIya AI-yê ku bi OpenAI û Anthropic re hevaheng e, bi bangkirina fonksiyonan, lêgerîna webê û derketinên strukturkirî.

Kilîta API-ya xwe bistînePlaygroundê biceribîneV2
Belge
  • Têkilî
  • Pêşandanan
  • Destpêka zû
  • API PlaygroundNû
  • Rastandin
  • Model
  • Bangkirina fonksiyonê
  • Derketinên strukturkirî
  • Streaming
  • Lêgerîna webê
  • Anthropic
  • SDK
  • Çewtî
  • Loga guherandinan

Shannon AI API Documentation

Têkilî

Docsên giştî

Hemû tiştên ku pêdivî ye ji bo hilweşandinê bi APIya Shannon a ku bi OpenAI û Anthropic re hevaheng e.

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

Chat Completions API bi bangkirina fonksiyon û streaming bikar bîne.

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

Formata Claude Messages bi amûr û headerê anthropic-version.

HeaderNasname
Authorization: Bearer <api-key>

Yan jî X-API-Key bi anthropic-version ji bo bangên şêwazê Claude.

GihîştinRewş
Docsên giştî - ji bo bang kirinê pêdivî bi kilîd e

Streaming, bangkirina fonksiyon, derketinên strukturkirî, lêgerîna webê.

Rêza kontrola destpêkê
  • ✓
    SDK‑a xwe ber bi Shannon re bîne
    baseURL ê li ser endpoints‑ên OpenAI an Anthropic yên jor biavêje.
    Sazdan
  • ✓
    Kilîda API‑a xwe biqedîne
    Ji bo bangên OpenAI Bearer tokenan an X-API-Key + anthropic-version bikar bîne.
    Ewlehî
  • ✓
    Amûr û structured outputs çalak bike
    OpenAI tools/functions, JSON schema û built-in web_search piştgirî dike.
    Şopandin
  • ✓
    Bikaranînê bişopîne
    Dema ku têketî yî, li vê rûpelê xercê token û lêgerînê bibîne.
    Analîtîk

Pêşandanan

OpenAI + Anthropic

Cihgirtina drop‑in ji bo APIyên OpenAI û Anthropic, bi piştgiriya amûran, derketinên strukturkirî û lêgerîna webê ya avakirî.

Drop‑in Replacement

Hevaheng

Bi SDK‑ên OpenAI û Anthropic re dixebite. Tenê base URL biguherîne.

Bangkirina fonksiyon

Amûr

Amûran define bike, Shannon wan dibangîne. Modi auto, forced, none piştgirî dike.

Lêgerîna webê ya built‑in

Lêgerîn

Lêgerîna webê bi demê rast bi jêderan. Otomatîk heye.

Derketinên strukturkirî

JSON

Moda JSON û JSON Schema enforcement ji bo derxistina daneyan.

Amûrên multi‑turn

Agentîk

Loopên otomatîk ên xebitandina fonksiyonan. Heta 10 iterasyonan.

Streaming

Lez

Server‑Sent Events ji bo streaming‑a tokenan bi demê rast.

Destpêka zû

5 deqe

Di sê gavên de dest pê bikin. Shannon mîna klîentên OpenAI û Anthropic dike.

1

base URL‑a xwe saz bike

Endpointa hevaheng ya OpenAI bikar bîne.

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

Kilîda API‑a xwe zêde bike

Di headerê Authorization de Bearer auth bikar bîne.

3

Peyama xwe ya yekem bişîne

Ziman hilbijêre û kilîda xwe biguherîne.

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)

Formata bersivê

Bersiva serkeftî
{
  "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

Nû

Shannon API rasterast di nav geroka xwe de test bike. Daxwazê çêbike, bixebitîne û bersivê bi demê rast bibîne.

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
}

Rastandin

Hemû daxwazên API bi kilîta Shannon API pêdivî ye were rastandin.

Formata OpenAI (pêşniyarkirî)

HTTP
Authorization: Bearer YOUR_API_KEY

Formata Anthropic

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

Model

Shannon gelek modelên ku ji bo cihên bikaranînê cuda hatine optimize kirin pêşkêş dike.

shannon-balanced-grpoBalanced

Bersivên bilez û bandorker ji bo karên rojane

Kontekst128K
Herî baş ji boChat, Q&A, Çêkirina naverokê
shannon-deep-dapoDeep

Rizvanîya pêşkeftî ji bo pirsgirêkên tevlihev

Kontekst128K
Herî baş ji boAnalîz, Lêkolîn, Karên tevlihev
shannon-coder-1Coder

Ji bo Claude Code CLI bi quota‑ya li ser bangê hate xelat kirin

Kontekst128K
Herî baş ji boÇêkirina kodê, Bikarhêneriya amûran, Integrasyona CLI
Quota ya li ser bang

Bangkirina fonksiyonê

Amûrên ku Shannon dikare banga wan bike ji bo kirinê an jî wergirtina agahî diyar bikin.

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

Vebijarkên hilbijartina amûran

"auto"Model biryar dide ku fonksiyon bibe bangkirin an na (default)
"none"Ji bo vê daxwazê bangkirina fonksiyonan bigire
{"type": "function", "function": {"name": "..."}}Bangkirina fonksiyonekê taybet bipêşîne

Bersiva bangkirina fonksiyon

Gava model fonksiyon dibangîne
{
  "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"
    }
  ]
}

Derketinên strukturkirî

Shannon bi JSONê derbasdar re bersiv bide ku bi şemayê te re hevaheng e.

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

Vebijarkên formata bersivê

{"type": "json_object"}Derketina JSON ya derbasdar mecbûr bike (bê schema taybet)
{"type": "json_schema", "json_schema": {...}}Derketina ku bi schema‑ya te ya rastî re têkçûyî ye mecbûr bike

Streaming

Ji bo UI yên bersivdar, streaming‑a tokena dem‑rast bi Server‑Sent Events çalak bikin.

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)
Tîp: Bersivên streaming wek Server‑Sent Events tên. Her parçeyek delta‑yek bi naveroka qismî tê de heye.

Lêgerîna webê

Shannon tê de web_search‑a hundirîn heye ku bi awayek otomatik peyda ye.

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
Pro Tîp: Encamên lêgerîna webê jêderan dihewîne. Shannon bi awtomatîk jêderan cite dike.

Anthropic

Shannon formatê Anthropic Messages API jî piştgirî dike.

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ê pêwîst: Formata Anthropic pêdivî bi anthropic-version: 2023-06-01 heye.

SDK

Hevaheng

Her SDK‑a OpenAI an Anthropic bikar bînin — tenê base URL biguherînin.

SDK‑ên OpenAI‑hevaheng

Python

SDK‑a fermî ya OpenAI Python - bi Shannon re dixebite

pip install openai
Docs bibîne
JavaScript / TypeScript

SDK‑a fermî ya OpenAI Node.js - bi Shannon re dixebite

npm install openai
Docs bibîne
Go

Klienta komînî ya Go ji bo API‑ên OpenAI‑hevaheng

go get github.com/sashabaranov/go-openai
Docs bibîne
Ruby

Klienta komînî ya Ruby ji bo API‑ên OpenAI‑hevaheng

gem install ruby-openai
Docs bibîne
PHP

Klienta komînî ya PHP ji bo API‑ên OpenAI‑hevaheng

composer require openai-php/client
Docs bibîne
Rust

Klienta Async Rust ji bo API‑ên OpenAI‑hevaheng

cargo add async-openai
Docs bibîne

SDK‑ên Anthropic‑hevaheng

Python (Anthropic)

SDK‑a fermî ya Anthropic Python - bi Shannon re dixebite

pip install anthropic
Docs bibîne
TypeScript (Anthropic)

SDK‑a fermî ya Anthropic TypeScript - bi Shannon re dixebite

npm install @anthropic-ai/sdk
Docs bibîne

Çewtî

Shannon kodên standard ên rewşa HTTP bikar tîne û peyamên çewtiyê yên detaydar vedigere.

400Daxwaza çewtFormata daxwazê an parametreyên çewt
401Ne‑destûrKilîda API ya çewt an winda
402Quota derbas bûQuota ya token an lêgerîn derbas bû
429Sînorê rêjeyêPir daxwaz, herî hîn neke
500Çewtiya serverêÇewtiya navxweyî, paşê dubare biceribîne

Formata bersiva çewtiyê

Bersiva çewtiyê
{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Loga guherandinan

Nûvekirin û baştirinên nêzîk li Shannon API.

v2.1.0
2025-01-03
  • NûModêla shannon-coder-1 ji bo Claude Code CLI integrasyon hate zêdekirin
  • NûSîstema quota ya li ser bang ji bo modêla Coder
  • BihezkirîEwlehiya bangkirina fonksiyonan hate başkirin
v2.0.0
2024-12-15
  • NûKompatîbilîtiya Anthropic Messages API hate zêdekirin
  • NûXebitandina amûrên multi‑turn (heta 10 iterasyonan)
  • NûPiştgirî ya formata bersivê ya JSON Schema
  • BihezkirîLêgerîna webê bi jêderên baştir hate başkirin
v1.5.0
2024-11-20
  • NûModêla shannon-deep-dapo ji bo rizvanîya tevlihev hate zêdekirin
  • NûBuilt‑in web_search
  • BihezkirîDerengiya bersivên streaming kêm bû
v1.0.0
2024-10-01
  • NûWeşana destpêkê ya API
  • NûEndpointa chat completions ya OpenAI‑hevaheng
  • NûPiştgirî ya bangkirina fonksiyon
  • NûStreaming bi Server‑Sent Events

Ji bo avakirinê amade ye?

Kilîta API‑ya xwe bistîne û îro bi Shannon AI re avakirinê dest pê bike.

Kilîta API çêbikeBelgeyê bibîne