Logoja e SHANNON A.I.
SHANNONA.I.
BisedëÇmimetAPIHulumtimKompaniaPentest AIStartup Boost

Po ngarkohet ndërfaqja e Shannon...

Po kontrollohet statusi...
Dokumentacion API

Shannon API

API i pajtueshëm me OpenAI dhe Anthropic me thirrje funksionesh, kërkim në ueb dhe dalje të strukturuara.

Merr çelësin tënd APIProvo PlaygroundV2
Dokumentacion
  • Përmbledhje
  • Aftësitë
  • Fillim i shpejtë
  • API PlaygroundE re
  • Autentikim
  • Modelet
  • Thirrje funksionesh
  • Dalje të strukturuara
  • Transmetim
  • Kërkim i integruar në ueb
  • Formati Anthropic
  • SDK
  • Trajtimi i gabimeve
  • Ndryshime

Shannon AI API Documentation

Përmbledhje

Dokumentacion publik

Gjithçka që ju nevojitet për të publikuar me API-në e pajtueshme me OpenAI dhe Anthropic të Shannon.

URL bazëI pajtueshëm me OpenAI
https://us-central1-shannonai.cloudfunctions.net/v1/chat/completions

Përdorni API Chat Completions me thirrje funksionesh dhe streaming.

URL bazëI pajtueshëm me Anthropic
https://us-central1-shannonai.cloudfunctions.net/v1/messages

Formati Claude Messages me mjete dhe header anthropic-version.

HTTPAutentikim
Authorization: Bearer <api-key>

Ose X-API-Key me anthropic-version për thirrje në stilin Claude.

AksesStatusi
Dokumentacion publik - çelësi kërkohet për thirrje

Streaming, thirrje funksionesh, dalje të strukturuara, kërkim në ueb.

Lista e nisjes
  • ✓
    Drejto SDK-në tënde te Shannon
    Vendos baseURL në endpoint-et OpenAI ose Anthropic më lart.
    Konfigurim
  • ✓
    Shto çelësin tënd API
    Përdor tokenë Bearer për thirrjet OpenAI ose X-API-Key + anthropic-version.
    Siguri
  • ✓
    Aktivizo mjetet dhe daljet e strukturuara
    Mbështet mjetet/funksionet OpenAI, skemën JSON dhe web_search të integruar.
    Aftësi
  • ✓
    Ndiq përdorimin
    Shiko konsumimin e tokenëve dhe kërkimeve në këtë faqe kur je i identifikuar.
    Analitikë

Aftësitë

OpenAI + Anthropic

Zëvendësim plug-and-play për API-të OpenAI dhe Anthropic me mbështetje native për mjete, dalje të strukturuara dhe kërkim të integruar në ueb.

Zëvendësim i menjëhershëm

Kompatibil

Punon me SDK-të OpenAI dhe Anthropic. Thjesht ndrysho URL-në bazë.

Thirrje funksionesh

Mjete

Përcakto mjete, lëre Shannon t’i thërrasë. Mbështet mënyrat auto, forced dhe none.

Kërkim i integruar në ueb

Kërkim

Kërkim në kohë reale me citime burimesh. Automatikisht i disponueshëm.

Dalje të strukturuara

JSON

Modaliteti JSON dhe zbatimi i skemës JSON për nxjerrje të besueshme të të dhënave.

Mjete me shumë rrotullime

Agjentik

Cikle automatike ekzekutimi funksionesh. Deri në 10 iteracione për kërkesë.

Transmetim

Shpejt

Server-sent events për transmetim tokenësh në kohë reale.

Fillim i shpejtë

5 minuta

Nisuni në tre hapa. Shannon pasqyron klientët OpenAI dhe Anthropic.

1

Vendos URL-në bazë

Përdor endpoint-in e pajtueshëm me OpenAI.

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

Shto çelësin tënd API

Përdor Bearer auth në header Authorization.

3

Dërgo mesazhin tënd të parë

Zgjidh një gjuhë dhe zëvendëso çelësin tënd.

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)

Formati i përgjigjes

Përgjigje e suksesshme
{
  "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

E re

Testo Shannon API direkt në shfletues. Ndërto kërkesën, ekzekutoje dhe shiko përgjigjen në kohë reale.

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
}

Autentikim

Të gjitha kërkesat API kërkojnë autentikim duke përdorur çelësin tënd Shannon API.

Formati OpenAI (i rekomanduar)

HTTP
Authorization: Bearer YOUR_API_KEY

Formati Anthropic

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

Modelet

Shannon ofron disa modele të optimizuara për përdorime të ndryshme.

shannon-balanced-grpoBalanced

Përgjigje të shpejta dhe efikase për detyra të përditshme

Konteksti128K
Më i miri përBisedë, Pyetje-Përgjigje, Gjenerim Përmbajtjeje
shannon-deep-dapoDeep

Arsyetim i avancuar për probleme komplekse

Konteksti128K
Më i miri përAnalizë, Kërkim, Detyra komplekse
shannon-coder-1Coder

Optimizuar për Claude Code CLI me kuotë sipas thirrjes

Konteksti128K
Më i miri përGjenerim kodi, Përdorim mjetesh, Integrim CLI
Kuotë sipas thirrjes

Thirrje funksionesh

Përcakto mjete që Shannon mund t’i thërrasë për të kryer veprime ose për të marrë informacion.

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

Opsionet e zgjedhjes së mjetit

"auto"Modeli vendos nëse të thërrasë funksion (parazgjedhur)
"none"Çaktivizo thirrjen e funksioneve për këtë kërkesë
{"type": "function", "function": {"name": "..."}}Detyro një thirrje funksioni specifike

Përgjigja e thirrjes së funksionit

Kur modeli thërret një funksion
{
  "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"
    }
  ]
}

Dalje të strukturuara

Detyro Shannon të përgjigjet me JSON të vlefshëm që përputhet me skemën tënde.

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

Opsionet e formatit të përgjigjes

{"type": "json_object"}Detyro dalje JSON të vlefshme (pa skemë specifike)
{"type": "json_schema", "json_schema": {...}}Detyro dalje që përputhet me skemën tënde të saktë

Transmetim

Aktivizo transmetimin e tokenëve në kohë reale me Server-Sent Events për UI të përgjegjshme.

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)
Këshillë: Përgjigjet stream vijnë si Server-Sent Events. Çdo pjesë përmban një delta me përmbajtje të pjesshme.

Kërkim i integruar në ueb

Shannon përfshin një funksion të integruar web_search që është automatikisht i disponueshëm.

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
Këshillë Pro: Rezultatet e kërkimit në ueb përfshijnë citime. Shannon do të citojë automatikisht burimet.

Formati Anthropic

Shannon mbështet gjithashtu formatin 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 i kërkuar: Formati Anthropic kërkon anthropic-version: 2023-06-01.

SDK

Kompatibil

Përdor çdo SDK OpenAI ose Anthropic — thjesht ndrysho URL-në bazë.

SDK të pajtueshme me OpenAI

Python

SDK zyrtar OpenAI Python - funksionon me Shannon

pip install openai
Shiko dokumentet
JavaScript / TypeScript

SDK zyrtar OpenAI Node.js - funksionon me Shannon

npm install openai
Shiko dokumentet
Go

Klient Go nga komuniteti për API të pajtueshme me OpenAI

go get github.com/sashabaranov/go-openai
Shiko dokumentet
Ruby

Klient Ruby nga komuniteti për API të pajtueshme me OpenAI

gem install ruby-openai
Shiko dokumentet
PHP

Klient PHP nga komuniteti për API të pajtueshme me OpenAI

composer require openai-php/client
Shiko dokumentet
Rust

Klient Rust asinkron për API të pajtueshme me OpenAI

cargo add async-openai
Shiko dokumentet

SDK të pajtueshme me Anthropic

Python (Anthropic)

SDK zyrtar Anthropic Python - funksionon me Shannon

pip install anthropic
Shiko dokumentet
TypeScript (Anthropic)

SDK zyrtar Anthropic TypeScript - funksionon me Shannon

npm install @anthropic-ai/sdk
Shiko dokumentet

Trajtimi i gabimeve

Shannon përdor kode standarde statusi HTTP dhe kthen mesazhe të detajuara gabimi.

400Kërkesë e keqeFormati i kërkesës ose parametrat janë të pavlefshëm
401I paautorizuarÇelës API i pavlefshëm ose mungon
402Kuota e tejkaluarKuota e tokenëve ose kërkimeve u tejkalua
429E kufizuarShumë kërkesa, ngadalësoni
500Gabim serveriGabim i brendshëm, provoni më vonë

Formati i përgjigjes së gabimit

Përgjigje gabimi
{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Ndryshime

Përditësime dhe përmirësime të fundit të Shannon API.

v2.1.0
2025-01-03
  • E reU shtua modeli shannon-coder-1 për integrimin me Claude Code CLI
  • E reSistem kuotash sipas thirrjes për modelin Coder
  • E përmirësuarU përmirësua besueshmëria e thirrjes së funksioneve
v2.0.0
2024-12-15
  • E reU shtua pajtueshmëria me Anthropic Messages API
  • E reEkzekutim mjetesh me shumë rrotullime (deri në 10 iteracione)
  • E reMbështetje për formatin e përgjigjes JSON Schema
  • E përmirësuarKërkim në ueb i përmirësuar me citime më të mira
v1.5.0
2024-11-20
  • E reU shtua modeli shannon-deep-dapo për arsyetim kompleks
  • E reFunksion i integruar web_search
  • E përmirësuarU ul vonesa për përgjigje streaming
v1.0.0
2024-10-01
  • E rePublikimi fillestar i API
  • E reEndpoint i pajtueshëm me OpenAI chat completions
  • E reMbështetje për thirrje funksionesh
  • E reStreaming përmes Server-Sent Events

Gati për të ndërtuar?

Merr çelësin tënd API dhe fillo të ndërtosh me Shannon AI sot.

Merr çelësin tënd APIShiko çmimet