SHANNON A.I. Logó
SHANNONA.I.
ChatÁrazásAPIKutatásCégPentest AIStartup Boost

Shannon felület betöltése...

Állapot ellenőrzése...
API dokumentáció

Shannon API

OpenAI- és Anthropic‑kompatibilis AI API funkcióhívással, webes kereséssel és strukturált kimenetekkel.

API‑kulcs kérésePlayground kipróbálásaV2
Dokumentáció
  • Áttekintés
  • Képességek
  • Gyors kezdés
  • PlaygroundÚj
  • Hitelesítés
  • Modellek
  • Funkcióhívás
  • Strukturált kimenetek
  • Streaming
  • Beépített webes keresés
  • Anthropic formátum
  • SDK-k
  • Hibakezelés
  • Változásnapló

Shannon AI API Documentation

Áttekintés

Nyilvános dokumentumok

Minden, amire szükséged van a Shannon OpenAI/Anthropic kompatibilis API-jával való induláshoz.

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

Használd a Chat Completions API-t függvényhívással és streameléssel.

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

Claude Messages formátum eszközökkel és anthropic-version fejléccel.

FejlécekHitelesítés
Hitelesítés: Bearer <kulcsod>

Vagy X-API-Key anthropic-versionnel a Claude‑stílusú hívásokhoz.

HozzáférésÁllapot
Nyilvános dokumentumok – kulcs szükséges a híváshoz

Streaming, függvényhívás, strukturált kimenetek, webes keresés.

Indítási ellenőrzőlista
  • ✓
    Irányítsd az SDK‑t a Shannonra
    Állítsd a baseURL‑t a fenti OpenAI vagy Anthropic végpontokra.
    Beállítás
  • ✓
    Csatold az API‑kulcsodat
    Használj Bearer tokent az OpenAI hívásokhoz vagy X-API-Key + anthropic-version.
    Biztonság
  • ✓
    Eszközök és strukturált kimenetek engedélyezése
    Támogatja az OpenAI eszközöket/funkciókat, JSON sémát és a beépített web_search-t.
    Képességek
  • ✓
    Használat követése
    Nézd meg a token- és keresési fogyasztást ezen az oldalon, ha be vagy jelentkezve.
    Analitika

Képességek

OpenAI + Anthropic

Drop‑in helyettesítés az OpenAI és Anthropic API-khoz, natív eszköz-, strukturált kimenet- és beépített webes keresés támogatással.

Drop‑in helyettesítés

Kompatibilis

Működik az OpenAI és Anthropic SDK-kkal. Csak a base URL-t kell módosítani.

Függvényhívás

Eszközök

Definiálj eszközöket, a Shannon meghívja őket. Támogatja az auto, forced és none módot.

Beépített webes keresés

Keresés

Valós idejű webes keresés forrás‑hivatkozásokkal. Automatikusan elérhető.

Strukturált kimenetek

JSON

JSON mód és JSON Schema kényszerítés megbízható adatkivonáshoz.

Többfordulós eszközök

Agentikus

Automatikus függvény‑végrehajtási ciklusok. Kérésenként akár 10 iteráció.

Streaming

Gyors

Server‑sent events a valós idejű token‑streameléshez.

Gyors kezdés

5 perc

Indulj három lépésben. Shannon tükrözi az OpenAI és Anthropic klienseket.

1

Állítsd be a base URL‑t

Használd az OpenAI‑kompatibilis végpontot.

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

Add hozzá az API‑kulcsodat

Használd a Bearer hitelesítést az Authorization fejlécben.

3

Küldd el az első üzeneted

Válassz nyelvet és cseréld be a kulcsodat.

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)

Válaszformátum

Sikeres válasz
{
  "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

Új

Teszteld a Shannon API-t közvetlenül a böngészőben. Készíts kérést, futtasd és nézd a választ valós időben.

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
}

Hitelesítés

Minden API‑kérés hitelesítést igényel a Shannon API‑kulcsoddal.

OpenAI formátum (ajánlott)

HTTP
Authorization: Bearer YOUR_API_KEY

Anthropic formátum

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

Modellek

A Shannon több modellt kínál különböző felhasználásokhoz optimalizálva.

shannon-balanced-grpoBalanced

Gyors, hatékony válaszok mindennapi feladatokra

Kontekstus128K
Legjobb ehhezChat, Kérdések és válaszok, Tartalomkészítés
shannon-deep-dapoDeep

Fejlett érvelés összetett problémákhoz

Kontekstus128K
Legjobb ehhezElemzés, Kutatás, Összetett feladatok
shannon-coder-1Coder

Optimalizálva a Claude Code CLI-hez hívás alapú kvótával

Kontekstus128K
Legjobb ehhezKódgenerálás, Eszközhasználat, CLI integráció
Hívás alapú kvóta

Funkcióhívás

Definiálj eszközöket, amelyeket a Shannon meghívhat műveletek végrehajtására vagy információ lekérésére.

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

Eszközválasztási lehetőségek

"auto"A modell eldönti, hív-e függvényt (alapértelmezett)
"none"Függvényhívás letiltása ehhez a kéréshez
{"type": "function", "function": {"name": "..."}}Egy adott függvényhívás kikényszerítése

Függvényhívás válasza

Amikor a modell függvényt hív
{
  "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"
    }
  ]
}

Strukturált kimenetek

Kényszerítsd a Shannont, hogy érvényes JSON-nal válaszoljon, amely megfelel a sémádnak.

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

Válaszformátum lehetőségek

{"type": "json_object"}Érvényes JSON kimenet kikényszerítése (nincs konkrét séma)
{"type": "json_schema", "json_schema": {...}}Kimenet kikényszerítése, amely megfelel a pontos sémádnak

Streaming

Valós idejű token‑streamelés Server‑Sent Events segítségével reszponzív felületekhez.

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)
Tipp: A streaming válaszok Server‑Sent Events formában érkeznek. Minden chunk egy delta‑t tartalmaz részleges tartalommal.

Beépített webes keresés

A Shannon tartalmaz egy beépített web_search funkciót, amely automatikusan elérhető.

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 tipp: A webes keresési találatok hivatkozásokat tartalmaznak. A Shannon automatikusan idézi a forrásokat.

Anthropic formátum

A Shannon az Anthropic Messages API formátumát is támogatja.

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)
Kötelező fejléc: Az Anthropic formátumhoz anthropic-version: 2023-06-01 szükséges.

SDK-k

Kompatibilis

Használj bármilyen OpenAI vagy Anthropic SDK-t – csak a base URL-t kell módosítani.

OpenAI‑kompatibilis SDK-k

Python

Hivatalos OpenAI Python SDK – működik a Shannonnal

pip install openai
Dokumentáció megtekintése
JavaScript / TypeScript

Hivatalos OpenAI Node.js SDK – működik a Shannonnal

npm install openai
Dokumentáció megtekintése
Go

Közösségi Go kliens OpenAI‑kompatibilis API-khoz

go get github.com/sashabaranov/go-openai
Dokumentáció megtekintése
Ruby

Közösségi Ruby kliens OpenAI‑kompatibilis API-khoz

gem install ruby-openai
Dokumentáció megtekintése
PHP

Közösségi PHP kliens OpenAI‑kompatibilis API-khoz

composer require openai-php/client
Dokumentáció megtekintése
Rust

Aszinkron Rust kliens OpenAI‑kompatibilis API-khoz

cargo add async-openai
Dokumentáció megtekintése

Anthropic‑kompatibilis SDK-k

Python (Anthropic)

Hivatalos Anthropic Python SDK – működik a Shannonnal

pip install anthropic
Dokumentáció megtekintése
TypeScript (Anthropic)

Hivatalos Anthropic TypeScript SDK – működik a Shannonnal

npm install @anthropic-ai/sdk
Dokumentáció megtekintése

Hibakezelés

A Shannon szabványos HTTP státuszkódokat használ, és részletes hibaüzeneteket ad vissza.

400Hibás kérésÉrvénytelen kérésformátum vagy paraméterek
401Nem jogosultÉrvénytelen vagy hiányzó API‑kulcs
402Kvóta túllépveToken‑ vagy keresési kvóta túllépve
429Korlátozott sebességTúl sok kérés, lassíts
500SzerverhibaBelső hiba, próbáld később

Hibaválasz formátuma

Hibaválasz
{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Változásnapló

Legutóbbi frissítések és fejlesztések a Shannon API-hoz.

v2.1.0
2025-01-03
  • ÚjHozzáadva a shannon-coder-1 modell a Claude Code CLI integrációhoz
  • ÚjHívásalapú kvótarendszer a Coder modellhez
  • FejlesztveA függvényhívás megbízhatóságának javítása
v2.0.0
2024-12-15
  • ÚjAnthropic Messages API kompatibilitás hozzáadva
  • ÚjTöbbfordulós eszközvégrehajtás (akár 10 iteráció)
  • ÚjJSON Schema válaszformátum támogatás
  • FejlesztveWebes keresés javítva jobb hivatkozásokkal
v1.5.0
2024-11-20
  • ÚjHozzáadva a shannon-deep-dapo modell összetett érveléshez
  • ÚjBeépített web_search funkció
  • FejlesztveCsökkentett késleltetés a streaming válaszoknál
v1.0.0
2024-10-01
  • ÚjAz API kezdeti kiadása
  • ÚjOpenAI‑kompatibilis chat completions végpont
  • ÚjFüggvényhívás támogatás
  • ÚjStreaming Server‑Sent Events-en keresztül

Készen állsz a fejlesztésre?

Szerezd meg az API‑kulcsodat és kezdj el ma építeni a Shannon AI‑jal.

API‑kulcs kéréseÁrak megtekintése