Логотип 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.

ЗаголовкиАвтентифікація
Авторизація: 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.

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

Нове

Тестуйте API Shannon прямо у браузері. Створіть запит, запустіть і побачте відповідь у реальному часі.

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
Порада Pro: Результати веб‑пошуку містять цитати. 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‑сумісний endpoint chat completions
  • НовеПідтримка виклику функцій
  • НовеСтрімінг через Server‑Sent Events

Готові будувати?

Отримайте свій API ключ і почніть створювати з Shannon AI вже сьогодні.

Отримати API‑ключПереглянути ціни