Документация Shannon AI API

Обзор

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

Всё, что нужно для запуска с совместимой API Shannon для OpenAI и Anthropic.

Базовый URL Совместимо с OpenAI

https://api.shannon-ai.com/v1/chat/completions

Используйте Chat Completions API с function calling и streaming.

Базовый URL Совместимо с Anthropic

https://api.shannon-ai.com/v1/messages

Формат Claude Messages с tools и заголовком anthropic-version.

Заголовки Аутентификация

Авторизация: Bearer <ваш-ключ>

Или используйте X-API-Key с anthropic-version для вызовов в стиле Claude.

Access Status

Public docs - Key required to call

Streaming, function calling, структурированные ответы и веб-поиск.

Чеклист запуска

+

Подключите ваш SDK к Shannon

Установите baseURL на endpoint OpenAI или Anthropic выше.

Setup
+

Добавьте ваш API-ключ

Используйте Bearer для OpenAI или X-API-Key + anthropic-version.

Security
+

Включите tools и структурированные ответы

Поддерживаются OpenAI tools/functions, JSON schema и встроенный web_search.

Возможности
+

Отслеживайте использование

Смотрите расход токенов и поисков на этой странице после входа в аккаунт.

Analytics

Возможности

OpenAI + Anthropic

Прямая замена API OpenAI и Anthropic с нативной поддержкой tools, структурированных ответов и встроенного веб-поиска.

Прямая замена

Совместимо

Работает с SDK OpenAI и Anthropic. Достаточно изменить базовый URL.

Вызов функций

Инструменты

Определите инструменты и позвольте Shannon вызывать их. Поддерживает режимы auto, forced и none.

Встроенный веб‑поиск

Поиск

Веб‑поиск в реальном времени с цитированием источников. Доступен автоматически.

Структурированные ответы

JSON

Режим JSON и принудительное соблюдение JSON Schema для надежного извлечения данных.

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

Агентные

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

Стриминг

Быстро

Server‑Sent Events для потоковой передачи токенов в реальном времени.

Быстрый старт

5 минут

Начните за три шага. Shannon повторяет клиентов OpenAI и Anthropic.

Задайте базовый URL

Используйте OpenAI‑совместимый эндпоинт.

https://api.shannon-ai.com/v1/chat/completions

Добавьте API‑ключ

Используйте Bearer‑аутентификацию в заголовке Authorization.

Отправьте первое сообщение

Выберите язык и подставьте свой ключ.

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com/v1"
)

response = client.chat.completions.create(
    model="shannon-1.6-lite",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, Shannon!"}
    ],
    max_tokens=1024
)

print(response.choices[0].message.content)

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/v1'
});

const response = await client.chat.completions.create({
  model: 'shannon-1.6-lite',
  messages: [
    { role: 'system', content: 'You are a helpful assistant.' },
    { role: 'user', content: 'Hello, Shannon!' }
  ],
  max_tokens: 1024
});

console.log(response.choices[0].message.content);

package main

import (
    "context"
    "fmt"
    openai "github.com/sashabaranov/go-openai"
)

func main() {
    config := openai.DefaultConfig("YOUR_API_KEY")
    config.BaseURL = "https://api.shannon-ai.com/v1"
    client := openai.NewClientWithConfig(config)

    resp, err := client.CreateChatCompletion(
        context.Background(),
        openai.ChatCompletionRequest{
            Model: "shannon-1.6-lite",
            Messages: []openai.ChatCompletionMessage{
                {Role: "system", Content: "You are a helpful assistant."},
                {Role: "user", Content: "Hello, Shannon!"},
            },
            MaxTokens: 1024,
        },
    )
    if err != nil {
        panic(err)
    }
    fmt.Println(resp.Choices[0].Message.Content)
}

cURL

curl -X POST "https://api.shannon-ai.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-1.6-lite",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello, Shannon!"}
    ],
    "max_tokens": 1024
  }'

Формат ответа

Успешный ответ

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "Shannon 1.6 Lite",
  "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
  }
}

Песочница API

Новый

Проверьте Shannon API прямо в браузере. Сформируйте запрос, запустите его и смотрите ответ в реальном времени.

Chat, Responses, Messages

Switch across OpenAI Chat Completions, Responses, and Anthropic Messages without leaving the playground.

Stream live output

Run real requests, inspect raw JSON, and view stream events from the same operator console.

Reuse your key

Signed-in users can pull their Shannon API key straight into the dedicated playground workspace.

/ru/docs/playground

The playground now lives on its own route so the API docs stay Astro-rendered while the request builder remains an explicitly interactive client tool.

Попробовать Playground V2 Получить API‑ключ

Аутентификация

Все API-запросы требуют аутентификации с вашим API-ключом Shannon.

OpenAI Format (Recommended)

HTTP

Authorization: Bearer YOUR_API_KEY

Формат Anthropic

HTTP

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

Модели

Shannon предлагает несколько моделей, оптимизированных для разных сценариев использования.

shannon-1.6-lite Shannon 1.6 Lite

Fast, efficient responses for everyday tasks

Контекст 128K

Лучше всего для Chat, Q&A, Content Generation

shannon-1.6-pro Shannon 1.6 Pro

Advanced reasoning for complex problems

Контекст 128K

Лучше всего для Analysis, Research, Complex Tasks

shannon-2-lite Shannon 2 Lite

Контекст 128K

Лучше всего для

shannon-2-pro Shannon 2 Pro

Контекст 128K

Лучше всего для

shannon-coder-1 Shannon Coder

Optimized for Claude Code CLI with call-based quota

Контекст 128K

Лучше всего для Code Generation, Tool Use, CLI Integration

Call-based quota

Вызов функций

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://api.shannon-ai.com/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-1.6-lite",
    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}")

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/v1'
});

const tools = [
  {
    type: 'function',
    function: {
      name: 'get_weather',
      description: 'Get current weather for a location',
      parameters: {
        type: 'object',
        properties: {
          location: { type: 'string', description: "City name" },
          unit: { type: 'string', enum: ['celsius', 'fahrenheit'] }
        },
        required: ['location']
      }
    }
  }
];

const response = await client.chat.completions.create({
  model: 'shannon-1.6-lite',
  messages: [{ role: 'user', content: "What's the weather in Tokyo?" }],
  tools,
  tool_choice: 'auto'
});

if (response.choices[0].message.tool_calls) {
  const toolCall = response.choices[0].message.tool_calls[0];
  console.log('Function:', toolCall.function.name);
  console.log('Arguments:', toolCall.function.arguments);
}

Параметры выбора инструмента

"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

Ответ вызова функции

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

Структурированные ответы

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://api.shannon-ai.com/v1"
)

# Force JSON output with schema
response = client.chat.completions.create(
    model="shannon-1.6-lite",
    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"}

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/v1'
});

const response = await client.chat.completions.create({
  model: 'shannon-1.6-lite',
  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']
      }
    }
  }
});

const data = JSON.parse(response.choices[0].message.content);
console.log(data); // { name: "John Doe", age: 30, occupation: "engineer" }

Параметры формата ответа

{"type": "json_object"} Force valid JSON output (no specific schema)

{"type": "json_schema", "json_schema": {...}} Force output matching your exact schema

Потоковая передача

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://api.shannon-ai.com/v1"
)

# Enable streaming for real-time responses
stream = client.chat.completions.create(
    model="shannon-1.6-lite",
    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)

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/v1'
});

// Enable streaming for real-time responses
const stream = await client.chat.completions.create({
  model: 'shannon-1.6-lite',
  messages: [
    { role: 'user', content: 'Write a short poem about AI' }
  ],
  stream: true
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content;
  if (content) process.stdout.write(content);
}

Совет: Streaming responses arrive as Server-Sent Events. Each chunk contains a delta with partial content.

Встроенный веб‑поиск

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://api.shannon-ai.com/v1"
)

# Web search is automatically available!
# Shannon will use it when needed for current information

response = client.chat.completions.create(
    model="shannon-1.6-lite",
    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

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/v1'
});

// Web search is automatically available!
// Shannon will use it when needed for current information

const response = await client.chat.completions.create({
  model: 'shannon-1.6-lite',
  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']
      }
    }
  }]
});

console.log(response.choices[0].message.content);
// Response includes sources and citations

Совет профи: Результаты веб-поиска содержат источники. Shannon автоматически добавляет цитаты.

Формат Anthropic

Shannon также поддерживает формат Anthropic Messages API.

https://api.shannon-ai.com/v1/messages

Python

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com/messages"
)

response = client.messages.create(
    model="shannon-1.6-lite",
    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)

JavaScript

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/messages'
});

const response = await client.messages.create({
  model: 'shannon-1.6-lite',
  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']
    }
  }]
});

console.log(response.content[0].text);

Обязательный заголовок: Anthropic format requires anthropic-version: 2023-06-01.

SDK

Совместимо

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

OpenAI-Compatible SDKs

SDK Python

Official OpenAI Python SDK - works with Shannon

pip install openai

View Docs ->

SDK JavaScript / TypeScript

Official OpenAI Node.js SDK - works with Shannon

npm install openai

View Docs ->

SDK Go

Community Go client for OpenAI-compatible APIs

go get github.com/sashabaranov/go-openai

View Docs ->

SDK Ruby

Community Ruby client for OpenAI-compatible APIs

gem install ruby-openai

View Docs ->

SDK PHP

Community PHP client for OpenAI-compatible APIs

composer require openai-php/client

View Docs ->

SDK Rust

Async Rust client for OpenAI-compatible APIs

cargo add async-openai

View Docs ->

Anthropic-Compatible SDKs

SDK Python (Anthropic)

Official Anthropic Python SDK - works with Shannon

pip install anthropic

View Docs ->

SDK TypeScript (Anthropic)

Official Anthropic TypeScript SDK - works with Shannon

npm install @anthropic-ai/sdk

View Docs ->

Обработка ошибок

Shannon использует стандартные HTTP‑коды и возвращает подробные сообщения об ошибках.

400 Неверный запрос Неверный формат запроса или параметры

401 Неавторизован Неверный или отсутствующий API‑ключ

402 Квота превышена Превышена квота токенов или поиска

429 Ограничение скорости Слишком много запросов, снизьте скорость

500 Ошибка сервера Внутренняя ошибка, попробуйте позже

Формат ответа об ошибке

Ответ с ошибкой

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

Журнал изменений

LOG

Recent updates and improvements to the Shannon API.

v2.1.0

2025-01-03

Новое Added shannon-coder-1 model for Claude Code CLI integration
Новое Call-based quota system for Coder model
Improved Improved function calling reliability

v2.0.0

2024-12-15

Новое Added Anthropic Messages API compatibility
Новое Multi-turn tool execution (up to 10 iterations)
Новое JSON Schema response format support
Improved Enhanced web search with better citations

v1.5.0

2024-11-20

Новое Added shannon-deep-dapo model for complex reasoning
Новое Built-in web_search function
Improved Reduced latency for streaming responses

v1.0.0

2024-10-01

Новое Initial API release
Новое OpenAI-compatible chat completions endpoint
Новое Function calling support
Новое Streaming via Server-Sent Events

Ваш API‑ключ

Access

Используйте Bearer для OpenAI или X-API-Key + anthropic-version.

YOUR_API_KEY

Получить API‑ключ

Храните API‑ключ в секрете. Перегенерация создаст новый ключ и сделает старый недействительным.

Ваше использование

Смотрите расход токенов и поисков на этой странице после входа в аккаунт.

-- API‑вызовы

-- Использовано токенов

Shannon API

Обзор

Возможности

Прямая замена

Вызов функций

Встроенный веб‑поиск

Структурированные ответы

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

Стриминг

Быстрый старт

Задайте базовый URL

Добавьте API‑ключ

Отправьте первое сообщение

Формат ответа

Песочница API

Chat, Responses, Messages

Stream live output

Reuse your key

Аутентификация

OpenAI Format (Recommended)

Формат Anthropic

Модели

Вызов функций

Параметры выбора инструмента

Ответ вызова функции

Структурированные ответы

Параметры формата ответа

Потоковая передача

Встроенный веб‑поиск

Формат Anthropic

SDK

OpenAI-Compatible SDKs

Anthropic-Compatible SDKs

Обработка ошибок

Формат ответа об ошибке

Журнал изменений

Ваш API‑ключ

Ваше использование

Shannon Coder (shannon-coder-1)

Готовы начать?

Shannon AI API Documentation

Обзор

Возможности

Прямая замена

Вызов функций

Встроенный веб‑поиск

Структурированные ответы

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

Стриминг

Быстрый старт

Задайте базовый URL

Добавьте API‑ключ

Отправьте первое сообщение

Формат ответа

Песочница API

Chat, Responses, Messages

Stream live output

Reuse your key

Аутентификация

OpenAI Format (Recommended)

Формат Anthropic

Модели

Вызов функций

Параметры выбора инструмента

Ответ вызова функции

Структурированные ответы

Параметры формата ответа

Потоковая передача

Встроенный веб‑поиск

Формат Anthropic

SDK

OpenAI-Compatible SDKs

Anthropic-Compatible SDKs

Обработка ошибок

Формат ответа об ошибке

Журнал изменений

Ваш API‑ключ

Ваше использование

Shannon Coder (shannon-coder-1)

Готовы начать?