Logo SHANNON A.I.
SHANNONA.I.
ChatCeníkAPIVýzkumSpolečnostPentest AIStartup Boost

Načítání rozhraní Shannon...

Kontrola stavu...
API dokumentace

Shannon API

AI API kompatibilní s OpenAI a Anthropic s voláním funkcí, webovým vyhledáváním a strukturovanými výstupy.

Získat API klíčVyzkoušet PlaygroundV2
Dokumentace
  • Přehled
  • Možnosti
  • Rychlý start
  • PlaygroundNové
  • Ověření
  • Modely
  • Volání funkcí
  • Strukturované výstupy
  • Streaming
  • Vestavěné webové vyhledávání
  • Formát Anthropic
  • SDK
  • Zpracování chyb
  • Přehled změn

Shannon AI API Documentation

Přehled

Veřejné dokumenty

Vše, co potřebujete pro spuštění s OpenAI/Anthropic kompatibilním API Shannon.

Základní URLKompatibilní s OpenAI
https://us-central1-shannonai.cloudfunctions.net/v1/chat/completions

Použijte Chat Completions API s function calling a streamingem.

Základní URLKompatibilní s Anthropic
https://us-central1-shannonai.cloudfunctions.net/v1/messages

Formát Claude Messages s tools a hlavičkou anthropic-version.

HlavičkyOvěření
Autorizace: Bearer <vas-klic>

Nebo použijte X-API-Key s anthropic-version pro volání ve stylu Claude.

AccessStatus
Public docs - Key required to call

Streaming, function calling, strukturované výstupy a webové vyhledávání.

Spouštěcí checklist
  • ✓
    Nasměrujte svůj SDK na Shannon
    Nastavte baseURL na endpoint OpenAI nebo Anthropic výše.
    Setup
  • ✓
    Přidejte svůj API klíč
    Použijte Bearer pro OpenAI nebo X-API-Key + anthropic-version.
    Security
  • ✓
    Zapněte tools a strukturované výstupy
    Podporuje OpenAI tools/functions, JSON schema a vestavěné web_search.
    Možnosti
  • ✓
    Sledujte využití
    Na této stránce po přihlášení sledujte spotřebu tokenů a vyhledávání.
    Analytics

Možnosti

OpenAI + Anthropic

Přímá náhrada API OpenAI a Anthropic s nativní podporou tools, strukturovaných výstupů a webového vyhledávání.

Drop‑in náhrada

Kompatibilní

Funguje se SDK OpenAI a Anthropic. Stačí změnit základní URL.

Volání funkcí

Nástroje

Definujte nástroje, nechte Shannon je volat. Podporuje režimy auto, vynucený a žádný.

Vestavěné webové vyhledávání

Hledat

Vyhledávání v reálném čase s citacemi zdrojů. Automaticky dostupné.

Strukturované výstupy

JSON

Režim JSON a vynucení schématu JSON pro spolehlivou extrakci dat.

Vícekolové nástroje

Agentní

Automatické smyčky volání funkcí. Až 10 iterací na požadavek.

Streaming

Rychlé

Server‑sent events pro streamování tokenů v reálném čase.

Rychlý start

5 minut

Začněte ve třech krocích. Shannon zrcadlí klienty OpenAI a Anthropic.

1

Nastavte základní URL

Použijte endpoint kompatibilní s OpenAI.

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

Přidejte API klíč

Použijte Bearer auth v hlavičce Authorization.

3

Odešlete první zprávu

Vyberte jazyk a vložte svůj klíč.

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)

Formát odpovědi

Úspěšná odpověď
{
  "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
  }
}

Playground

Nové

Testujte Shannon API přímo v prohlížeči. Sestavte požadavek, spusťte ho a sledujte odpověď v reálném čase.

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
}

Ověření

Všechny API požadavky vyžadují autentizaci pomocí vašeho API klíče Shannon.

OpenAI Format (Recommended)

HTTP
Authorization: Bearer YOUR_API_KEY

Formát Anthropic

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

Modely

Shannon nabízí více modelů optimalizovaných pro různé případy použití.

shannon-balanced-grpoBalanced

Fast, efficient responses for everyday tasks

Kontext128K
Nejlepší proChat, Q&A, Content Generation
shannon-deep-dapoDeep

Advanced reasoning for complex problems

Kontext128K
Nejlepší proAnalysis, Research, Complex Tasks
shannon-coder-1Coder

Optimized for Claude Code CLI with call-based quota

Kontext128K
Nejlepší proCode Generation, Tool Use, CLI Integration
Call-based quota

Volání funkcí

Define tools that Shannon can call to perform actions or retrieve information.

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

Možnosti volby nástroje

"auto"Model decides whether to call a function (default)
"none"Disable function calling for this request
{"type": "function", "function": {"name": "..."}}Force a specific function call

Odpověď volání funkce

When model calls a 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"
    }
  ]
}

Strukturované výstupy

Force Shannon to respond with valid JSON that matches your schema.

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

Možnosti formátu odpovědi

{"type": "json_object"}Force valid JSON output (no specific schema)
{"type": "json_schema", "json_schema": {...}}Force output matching your exact schema

Streaming

Enable real-time token streaming with Server-Sent Events for responsive UIs.

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)
Tip: Streaming responses arrive as Server-Sent Events. Each chunk contains a delta with partial content.

Vestavěné webové vyhledávání

Shannon includes a built-in web_search function that's automatically available.

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 tip: Výsledky webového vyhledávání obsahují citace. Shannon bude zdroje citovat automaticky.

Formát Anthropic

Shannon také podporuje formát 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)
Povinná hlavička: Anthropic format requires anthropic-version: 2023-06-01.

SDK

Kompatibilní

Use any OpenAI or Anthropic SDK - just change the base URL.

OpenAI-Compatible SDKs

Python

Official OpenAI Python SDK - works with Shannon

pip install openai
View Docs
JavaScript / TypeScript

Official OpenAI Node.js SDK - works with Shannon

npm install openai
View Docs
Go

Community Go client for OpenAI-compatible APIs

go get github.com/sashabaranov/go-openai
View Docs
Ruby

Community Ruby client for OpenAI-compatible APIs

gem install ruby-openai
View Docs
PHP

Community PHP client for OpenAI-compatible APIs

composer require openai-php/client
View Docs
Rust

Async Rust client for OpenAI-compatible APIs

cargo add async-openai
View Docs

Anthropic-Compatible SDKs

Python (Anthropic)

Official Anthropic Python SDK - works with Shannon

pip install anthropic
View Docs
TypeScript (Anthropic)

Official Anthropic TypeScript SDK - works with Shannon

npm install @anthropic-ai/sdk
View Docs

Zpracování chyb

Shannon používá standardní HTTP kódy a vrací podrobné chybové zprávy.

400Špatný požadavekNeplatný formát požadavku nebo parametry
401NeautorizovánoNeplatný nebo chybějící API klíč
402Překročený limitPřekročen limit tokenů nebo vyhledávání
429Omezeno rychlostíPříliš mnoho požadavků, zpomalte
500Chyba serveruInterní chyba, zkuste později

Formát chybové odpovědi

Chybová odpověď
{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Přehled změn

Recent updates and improvements to the Shannon API.

v2.1.0
2025-01-03
  • NovéAdded shannon-coder-1 model for Claude Code CLI integration
  • NovéCall-based quota system for Coder model
  • ImprovedImproved function calling reliability
v2.0.0
2024-12-15
  • NovéAdded Anthropic Messages API compatibility
  • NovéMulti-turn tool execution (up to 10 iterations)
  • NovéJSON Schema response format support
  • ImprovedEnhanced web search with better citations
v1.5.0
2024-11-20
  • NovéAdded shannon-deep-dapo model for complex reasoning
  • NovéBuilt-in web_search function
  • ImprovedReduced latency for streaming responses
v1.0.0
2024-10-01
  • NovéInitial API release
  • NovéOpenAI-compatible chat completions endpoint
  • NovéFunction calling support
  • NovéStreaming via Server-Sent Events

Připraveni stavět?

Get your API key and start building with Shannon AI today.

Získat API klíčZobrazit ceny