Logo SHANNON A.I.
SHANNONA.I.
CzatCennikAPIBadaniaFirmaPentest AIStartup Boost

Ładowanie interfejsu Shannon...

Sprawdzanie statusu...
Dokumentacja API

API Shannon

API AI kompatybilne z OpenAI i Anthropic z wywołaniami funkcji, wyszukiwaniem w sieci i ustrukturyzowanymi odpowiedziami.

Uzyskaj klucz APIWypróbuj PlaygroundV2
Dokumentacja
  • Przegląd
  • Możliwości
  • Szybki start
  • Plac zabaw APINowe
  • Uwierzytelnianie
  • Modele
  • Wywołanie funkcji
  • Ustrukturyzowane odpowiedzi
  • Streaming
  • Wbudowane wyszukiwanie w sieci
  • Format Anthropic
  • SDK
  • Obsługa błędów
  • Dziennik zmian

Shannon AI API Documentation

Przegląd

Publiczne dokumenty

Wszystko, czego potrzebujesz, aby wdrożyć z API Shannon zgodnym z OpenAI i Anthropic.

Bazowy URLKompatybilne z OpenAI
https://us-central1-shannonai.cloudfunctions.net/v1/chat/completions

Użyj Chat Completions API z function calling i streamingiem.

Bazowy URLKompatybilne z Anthropic
https://us-central1-shannonai.cloudfunctions.net/v1/messages

Format Claude Messages z tools i nagłówkiem anthropic-version.

NagłówkiUwierzytelnianie
Autoryzacja: Bearer <twoj-klucz>

Lub użyj X-API-Key z anthropic-version dla wywołań w stylu Claude.

AccessStatus
Public docs - Key required to call

Streaming, function calling, ustrukturyzowane odpowiedzi i wyszukiwanie w sieci.

Lista startowa
  • ✓
    Skieruj swoje SDK do Shannon
    Ustaw baseURL na endpoint OpenAI lub Anthropic powyżej.
    Setup
  • ✓
    Dodaj swój klucz API
    Użyj Bearer dla OpenAI lub X-API-Key + anthropic-version.
    Security
  • ✓
    Włącz tools i ustrukturyzowane odpowiedzi
    Obsługuje OpenAI tools/functions, JSON schema i wbudowane web_search.
    Możliwości
  • ✓
    Śledź użycie
    Sprawdzaj zużycie tokenów i wyszukiwań na tej stronie po zalogowaniu.
    Analytics

Możliwości

OpenAI + Anthropic

Bezpośredni zamiennik API OpenAI i Anthropic z natywną obsługą tools, ustrukturyzowanych odpowiedzi i wyszukiwania w sieci.

Zamiennik typu drop‑in

Zgodne

Działa z SDK OpenAI i Anthropic. Wystarczy zmienić bazowy URL.

Wywoływanie funkcji

Narzędzia

Zdefiniuj narzędzia, a Shannon je wywoła. Obsługuje tryby auto, wymuszony i brak.

Wbudowane wyszukiwanie w sieci

Szukaj

Wyszukiwanie w czasie rzeczywistym z cytowaniami źródeł. Dostępne automatycznie.

Ustrukturyzowane wyjścia

JSON

Tryb JSON i wymuszanie schematu JSON dla niezawodnego wydobycia danych.

Narzędzia wieloetapowe

Agentowe

Automatyczne pętle wywołań funkcji. Do 10 iteracji na żądanie.

Streaming

Szybkie

SSE do strumieniowania tokenów w czasie rzeczywistym.

Szybki start

5 minut

Zacznij w trzech krokach. Shannon naśladuje klientów OpenAI i Anthropic.

1

Ustaw bazowy URL

Użyj endpointu zgodnego z OpenAI.

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

Dodaj klucz API

Użyj Bearer auth w nagłówku Authorization.

3

Wyślij pierwszą wiadomość

Wybierz język i wstaw swój klucz.

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)

Format odpowiedzi

Odpowiedź sukcesu
{
  "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
  }
}

Plac zabaw API

Nowe

Testuj API Shannon bezpośrednio w przeglądarce. Zbuduj żądanie, uruchom i zobacz odpowiedź w czasie rzeczywistym.

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
}

Uwierzytelnianie

Wszystkie żądania API wymagają uwierzytelnienia Twoim kluczem API Shannon.

OpenAI Format (Recommended)

HTTP
Authorization: Bearer YOUR_API_KEY

Format Anthropic

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

Modele

Shannon oferuje wiele modeli zoptymalizowanych pod różne przypadki użycia.

shannon-balanced-grpoBalanced

Fast, efficient responses for everyday tasks

Kontekst128K
Najlepsze doChat, Q&A, Content Generation
shannon-deep-dapoDeep

Advanced reasoning for complex problems

Kontekst128K
Najlepsze doAnalysis, Research, Complex Tasks
shannon-coder-1Coder

Optimized for Claude Code CLI with call-based quota

Kontekst128K
Najlepsze doCode Generation, Tool Use, CLI Integration
Call-based quota

Wywołanie funkcji

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

Opcje wyboru narzędzia

"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

Odpowiedź wywołania funkcji

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

Ustrukturyzowane odpowiedzi

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

Opcje formatu odpowiedzi

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

Wbudowane wyszukiwanie w sieci

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
Wskazówka pro: Wyniki wyszukiwania zawierają cytowania. Shannon automatycznie cytuje źródła.

Format Anthropic

Shannon obsługuje również format 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)
Wymagany nagłówek: Anthropic format requires anthropic-version: 2023-06-01.

SDK

Zgodne

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

Obsługa błędów

Shannon używa standardowych kodów HTTP i zwraca szczegółowe komunikaty błędów.

400Błędne żądanieNieprawidłowy format żądania lub parametry
401Brak autoryzacjiNieprawidłowy lub brakujący klucz API
402Przekroczony limitPrzekroczono limit tokenów lub wyszukiwań
429Ograniczenie szybkościZbyt wiele żądań, zwolnij
500Błąd serweraBłąd wewnętrzny, spróbuj ponownie później

Format odpowiedzi błędu

Odpowiedź błędu
{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Dziennik zmian

Recent updates and improvements to the Shannon API.

v2.1.0
2025-01-03
  • NoweAdded shannon-coder-1 model for Claude Code CLI integration
  • NoweCall-based quota system for Coder model
  • ImprovedImproved function calling reliability
v2.0.0
2024-12-15
  • NoweAdded Anthropic Messages API compatibility
  • NoweMulti-turn tool execution (up to 10 iterations)
  • NoweJSON Schema response format support
  • ImprovedEnhanced web search with better citations
v1.5.0
2024-11-20
  • NoweAdded shannon-deep-dapo model for complex reasoning
  • NoweBuilt-in web_search function
  • ImprovedReduced latency for streaming responses
v1.0.0
2024-10-01
  • NoweInitial API release
  • NoweOpenAI-compatible chat completions endpoint
  • NoweFunction calling support
  • NoweStreaming via Server-Sent Events

Gotowy do budowy?

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

Uzyskaj klucz APIZobacz ceny