Лого на SHANNON A.I.
SHANNONA.I.
ЧатЦениAPIИзследванияКомпанияPentest AIStartup Boost

Зареждане на Shannon интерфейс...

Проверка на статуса...
API документация

Shannon API

AI API, съвместим с OpenAI и Anthropic, с извикване на функции, уеб търсене и структурирани изходи.

Вземи API ключПробвай PlaygroundV2
Документация
  • Преглед
  • Възможности
  • Бърз старт
  • PlaygroundНово
  • Удостоверяване
  • Модели
  • Извикване на функции
  • Структурирани изходи
  • Стрийминг
  • Вградено уеб търсене
  • Anthropic формат
  • SDK
  • Обработка на грешки
  • Дневник на промените

Shannon AI API Documentation

Преглед

Публични документи

Всичко необходимо за стартиране с API на Shannon, съвместим с OpenAI и Anthropic.

Базов URLСъвместим с OpenAI
https://us-central1-shannonai.cloudfunctions.net/v1/chat/completions

Използвайте Chat Completions API с извикване на функции и стрийминг.

Базов URLСъвместим с Anthropic
https://us-central1-shannonai.cloudfunctions.net/v1/messages

Формат Claude Messages с инструменти и anthropic-version header.

ХедъриУдостоверяване
Авторизация: Bearer <вашият-ключ>

Или X-API-Key с anthropic-version за повиквания тип Claude.

ДостъпСтатус
Публични документи - ключът е необходим за заявка

Стрийминг, извикване на функции, структурирани изходи, уеб търсене.

Контролен списък за стартиране
  • ✓
    Насочете SDK към Shannon
    Задайте baseURL към горните OpenAI или Anthropic endpoints.
    Настройка
  • ✓
    Прикачете вашия API ключ
    Използвайте Bearer токени за OpenAI или X-API-Key + anthropic-version.
    Сигурност
  • ✓
    Активирайте инструменти и структурирани изходи
    Поддържа OpenAI tools/functions, JSON schema и вградена web_search.
    Възможности
  • ✓
    Проследете използването
    Вижте потреблението на токени и търсене на тази страница, когато сте влезли.
    Анализи

Възможности

OpenAI + Anthropic

Drop‑in заместител за OpenAI и Anthropic APIs с нативна поддръжка на инструменти, структурирани изходи и вградено уеб търсене.

Drop‑in заместител

Съвместим

Работи с OpenAI и Anthropic SDKs. Просто сменете base URL.

Извикване на функции

Инструменти

Дефинирайте инструменти, Shannon ги извиква. Поддържа auto, forced и none режими.

Вградено уеб търсене

Търсене

Уеб търсене в реално време с цитати на източници. Наличен автоматично.

Структурирани изходи

JSON

JSON режим и налагане на JSON Schema за надеждно извличане на данни.

Многоходови инструменти

Агентни

Автоматични цикли на изпълнение на функции. До 10 итерации на заявка.

Стрийминг

Бързо

Server‑Sent Events за стрийминг на токени в реално време.

Бърз старт

5 минути

Започнете в три стъпки. Shannon отразява клиентите на OpenAI и Anthropic.

1

Задайте base URL

Използвайте OpenAI‑съвместим endpoint.

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

Добавете вашия API ключ

Използвайте Bearer auth в Authorization header.

3

Изпратете първото си съобщение

Изберете език и поставете ключа си.

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)

Формат на отговора

Успешен отговор
{
  "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

Ново

Тествайте Shannon API директно в браузъра. Създайте заявка, стартирайте и вижте отговора в реално време.

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
}

Удостоверяване

Всички API заявки изискват удостоверяване с вашия Shannon API ключ.

OpenAI формат (препоръчително)

HTTP
Authorization: Bearer YOUR_API_KEY

Anthropic формат

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

Модели

Shannon предлага няколко модела, оптимизирани за различни случаи на употреба.

shannon-balanced-grpoBalanced

Бързи, ефективни отговори за ежедневни задачи

Контекст128K
Най‑подходящо заЧат, Q&A, генериране на съдържание
shannon-deep-dapoDeep

Напреднало разсъждение за сложни проблеми

Контекст128K
Най‑подходящо заАнализ, изследвания, сложни задачи
shannon-coder-1Coder

Оптимизиран за Claude Code CLI с квота на повиквания

Контекст128K
Най‑подходящо заГенериране на код, използване на инструменти, CLI интеграция
Квота на повиквания

Извикване на функции

Дефинирайте инструменти, които Shannon може да извика, за да изпълнява действия или да получи информация.

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

Опции за избор на инструмент

"auto"Моделът решава дали да извика функция (по подразбиране)
"none"Изключете извикването на функции за тази заявка
{"type": "function", "function": {"name": "..."}}Принудително извикване на конкретна функция

Отговор при Function Call

Когато моделът извика функция
{
  "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"
    }
  ]
}

Структурирани изходи

Принудете Shannon да отговори с валиден JSON, който съвпада с вашата схема.

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

Опции за формат на отговора

{"type": "json_object"}Принудителен валиден JSON изход (без конкретна схема)
{"type": "json_schema", "json_schema": {...}}Принудителен изход, съответстващ на вашата схема

Стрийминг

Включете стрийминг на токени в реално време чрез Server‑Sent Events за отзивчиви UI.

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)
Съвет: Стрийминг отговорите идват като Server‑Sent Events. Всеки chunk съдържа delta с частично съдържание.

Вградено уеб търсене

Shannon включва вградена функция web_search, която е достъпна автоматично.

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
Про съвет: Резултатите от уеб търсене съдържат цитати. Shannon автоматично ще цитира източници.

Anthropic формат

Shannon също поддържа формата 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: Anthropic форматът изисква anthropic-version: 2023-06-01.

SDK

Съвместим

Използвайте който и да е OpenAI или Anthropic SDK — просто сменете base URL.

OpenAI‑съвместими SDKs

Python

Официален OpenAI Python SDK - работи със Shannon

pip install openai
Виж документацията
JavaScript / TypeScript

Официален OpenAI Node.js SDK - работи със Shannon

npm install openai
Виж документацията
Go

Community Go клиент за OpenAI‑съвместими APIs

go get github.com/sashabaranov/go-openai
Виж документацията
Ruby

Community Ruby клиент за OpenAI‑съвместими APIs

gem install ruby-openai
Виж документацията
PHP

Community PHP клиент за OpenAI‑съвместими APIs

composer require openai-php/client
Виж документацията
Rust

Async Rust клиент за OpenAI‑съвместими APIs

cargo add async-openai
Виж документацията

Anthropic‑съвместими SDKs

Python (Anthropic)

Официален Anthropic Python SDK - работи със Shannon

pip install anthropic
Виж документацията
TypeScript (Anthropic)

Официален Anthropic TypeScript SDK - работи със Shannon

npm install @anthropic-ai/sdk
Виж документацията

Обработка на грешки

Shannon използва стандартни HTTP статус кодове и връща подробни съобщения за грешки.

400Невалидна заявкаНевалиден формат на заявката или параметри
401НеоторизиранНевалиден или липсващ API ключ
402Квотата е надвишенаНадвишена квота за токени или търсене
429Rate LimitТвърде много заявки, забавете
500Грешка в сървъраВътрешна грешка, опитайте по‑късно

Формат на отговора за грешка

Отговор за грешка
{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Дневник на промените

Последни обновления и подобрения на Shannon API.

v2.1.0
2025-01-03
  • НовоДобавен shannon-coder-1 модел за интеграция с Claude Code CLI
  • НовоСистема за квота на повиквания за Coder модела
  • ПодобреноПодобрена надеждност на извикване на функции
v2.0.0
2024-12-15
  • НовоДобавена съвместимост с Anthropic Messages API
  • НовоМногоходово изпълнение на инструменти (до 10 итерации)
  • НовоПоддръжка на JSON Schema формат за отговор
  • ПодобреноПодобрено уеб търсене с по‑добри цитати
v1.5.0
2024-11-20
  • НовоДобавен shannon-deep-dapo модел за сложни разсъждения
  • НовоВградена web_search функция
  • ПодобреноНамалена латентност при стрийминг отговори
v1.0.0
2024-10-01
  • НовоПървоначално издание на API
  • НовоOpenAI‑съвместим chat completions endpoint
  • НовоПоддръжка на извикване на функции
  • НовоСтрийминг чрез Server‑Sent Events

Готови ли сте да изграждате?

Вземете своя API ключ и започнете да изграждате с Shannon AI още днес.

Вземи API ключВиж цени