Shannon AI API Баримт бичиг

Тойм

Нийтийн баримт

Shannon-ийн OpenAI ба Anthropic-той нийцтэй API-г ашиглахад хэрэгтэй бүх зүйл.

URL OpenAI-Compatible

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

Chat Completions API-г function calling болон streaming-тай ашиглана уу.

URL Anthropic-Compatible

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

Claude Messages формат, tools болон anthropic-version header-тай.

HTTP Баталгаажуулалт

Authorization: Bearer <api-key>

Эсвэл Claude style дуудлагад X-API-Key болон anthropic-version.

Хандалт Төлөв

Нийтийн баримт - дуудлага хийхэд key шаардлагатай

Streaming, function calling, structured outputs, web search.

Эхлүүлэх жагсаалт

+

SDK-г Shannon руу чиглүүл

baseURL-г дээрх OpenAI эсвэл Anthropic endpoints руу тохируулна уу.

Тохиргоо
+

API түлхүүрээ холбоно уу

OpenAI дуудлагад Bearer token эсвэл X-API-Key + anthropic-version хэрэглэнэ.

Аюулгүй байдал
+

Tools ба structured outputs-ыг идэвхжүүлэх

OpenAI tools/functions, JSON schema болон built-in web_search дэмждэг.

Чадвар
+

Хэрэглээг хянах

Нэвтэрсэн үед энэ хуудсан дээр token болон search хэрэглээг харна уу.

Аналитик

Чадварууд

OpenAI + Anthropic

OpenAI болон Anthropic API-д зориулсан drop-in replacement; tools, structured outputs болон built-in web search дэмжинэ.

Drop-in Replacement

Compatible

OpenAI ба Anthropic SDK-уудтай ажиллана. base URL-ийг л соль.

Функц дуудах

Tools

Tools-оо тодорхойлоод Shannon-оор дуудуул. auto, forced, none горим дэмжинэ.

Вэб хайлт

Хайх

Бодит цагийн web search, эх сурвалжийн эшлэлтэй. Автоматаар боломжтой.

Бүтэцтэй гаралт

JSON

Найдвартай өгөгдөл гаргалтанд JSON mode болон JSON Schema enforcement.

Multi-turn Tools

Agentic

Автомат function execution loops. Нэг хүсэлтэд 10 iteration хүртэл.

Дамжуулалт

Fast

Server-sent events ашиглан real-time token streaming.

Түргэн эхлэх

5 минут

Гурван алхмаар эхэл. Shannon OpenAI болон Anthropic клиентийг дуурайлгана.

Base URL тохируул

OpenAI-compatible endpoint ашигла.

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

API түлхүүр нэмэх

Authorization header-д Bearer auth хэрэглэнэ.

Анхны мессеж илгээх

Хэлээ сонгоод key-гээ солиорой.

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

Response format

Success Response

{
  "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 Playground

ШИНЭ

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.

/mn/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-ийн бүх хүсэлт Shannon API key-ээр баталгаажуулалт шаарддаг.

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

Өдөр тутмын ажилд хурдан, үр ашигтай хариу

Контекст 128K

Аюулгүй байдлын мэргэжилтнүүдэд зориулан бүтээгдсэн Чат, Асуулт-Хариулт, Контент үүсгэх

shannon-1.6-pro Shannon 1.6 Pro

Төвөгтэй асуудалд гүн reasoning

Контекст 128K

Аюулгүй байдлын мэргэжилтнүүдэд зориулан бүтээгдсэн Анализ, Судалгаа, Төвөгтэй ажлууд

shannon-2-lite Shannon 2 Lite

Контекст 128K

Аюулгүй байдлын мэргэжилтнүүдэд зориулан бүтээгдсэн

shannon-2-pro Shannon 2 Pro

Контекст 128K

Аюулгүй байдлын мэргэжилтнүүдэд зориулан бүтээгдсэн

shannon-coder-1 Shannon Coder

Claude Code CLI-д зориулан call-based quota-тай оновчлогдсон

Контекст 128K

Аюулгүй байдлын мэргэжилтнүүдэд зориулан бүтээгдсэн Код үүсгэх, Tool ашиглах, CLI интеграц

Call-based quota

Функц дуудлага

Shannon-оор дуудуулж болох tools-оо тодорхойл; үйлдэл хийх эсвэл мэдээлэл авахад.

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" Модель функц дуудах эсэхийг өөрөө шийднэ (default)

"none" Энэ хүсэлтэд function calling-ийг унтраах

{"type": "function", "function": {"name": "..."}} Тодорхой function call-ыг албадуулах

Response format

Модель функц дуудах үед

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

Бүтэцтэй гаралт

Schema-даа нийцсэн зөв JSON-ийг буцаахаар Shannon-ыг албад.

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

Response format

{"type": "json_object"} Зөв JSON output (schemaгүй) албад

{"type": "json_schema", "json_schema": {...}} Таны schema-тай яг тохирох output-ыг албад

Дамжуулалт

Хурдан UI-д зориулж Server-Sent Events-ээр real-time token streaming идэвхжүүл.

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 хариунууд Server-Sent Events байдлаар ирнэ. Chunk бүр хэсэгчилсэн контентын delta агуулна.

Вэб хайлт

Shannon-д автомат боломжтой web_search функц бий.

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

Zovlogoo: Web search үр дүн нь эшлэлтэй байна. 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);

Required: Anthropic format-д anthropic-version: 2023-06-01 шаардлагатай.

SDK-ууд

Compatible

Ямар ч OpenAI эсвэл Anthropic SDK хэрэглэ — base URL-ийг л өөрчил.

OpenAI-Compatible SDKs

SDK Python

Official OpenAI Python SDK — Shannon-той ажиллана

pip install openai

Баримт харах ->

SDK JavaScript / TypeScript

Official OpenAI Node.js SDK — Shannon-той ажиллана

npm install openai

Баримт харах ->

SDK Go

OpenAI-compatible API-д зориулсан community Go client

go get github.com/sashabaranov/go-openai

Баримт харах ->

SDK Ruby

OpenAI-compatible API-д зориулсан community Ruby client

gem install ruby-openai

Баримт харах ->

SDK PHP

OpenAI-compatible API-д зориулсан community PHP client

composer require openai-php/client

Баримт харах ->

SDK Rust

OpenAI-compatible API-д зориулсан Async Rust client

cargo add async-openai

Баримт харах ->

Anthropic-Compatible SDKs

SDK Python (Anthropic)

Official Anthropic Python SDK — Shannon-той ажиллана

pip install anthropic

Баримт харах ->

SDK TypeScript (Anthropic)

Official Anthropic TypeScript SDK — Shannon-той ажиллана

npm install @anthropic-ai/sdk

Баримт харах ->

Алдаа боловсруулах

Shannon нь стандарт HTTP status code-ууд ашиглаж, дэлгэрэнгүй алдаа мессеж буцаана.

400 Bad Request Хүсэлтийн формат эсвэл параметрүүд буруу

401 Unauthorized API key буруу эсвэл байхгүй

402 Quota Exceeded Token эсвэл search quota хэтэрсэн

429 Rate Limited Хэт олон хүсэлт, удаашруулна уу

500 Server Error Дотоод алдаа, дараа нь дахин оролдоно уу

Error Response Format

Error Response

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

Өөрчлөлтийн жагсаалт

LOG

Shannon API-ийн сүүлийн шинэчлэлтүүд ба сайжруулалтууд.

v2.1.0

2025-01-03

ШИНЭ Claude Code CLI интеграцид зориулсан shannon-coder-1 модель нэмэгдсэн
ШИНЭ Coder модельд зориулсан call-based quota систем
Сайжруулсан Function calling найдвартай болсон

v2.0.0

2024-12-15

ШИНЭ Anthropic Messages API compatibility нэмэгдсэн
ШИНЭ Multi-turn tool execution (10 iterations хүртэл)
ШИНЭ JSON Schema response format дэмжлэг
Сайжруулсан Илүү сайн citations-тай web search сайжирсан

v1.5.0

2024-11-20

ШИНЭ Төвөгтэй reasoning-д зориулсан shannon-deep-dapo модель нэмэгдсэн
ШИНЭ Built-in web_search function
Сайжруулсан Streaming хариунуудын latency буурсан

v1.0.0

2024-10-01

ШИНЭ API-ийн анхны хувилбар
ШИНЭ OpenAI-compatible chat completions endpoint
ШИНЭ Function calling support
ШИНЭ Server-Sent Events-ээр streaming

Таны API түлхүүр

Хандалт

OpenAI дуудлагад Bearer token эсвэл X-API-Key + anthropic-version хэрэглэнэ.

YOUR_API_KEY

API түлхүүр авах

API түлхүүрээ нууц байлгаарай. Regenerate хийхэд шинэ түлхүүр үүсч хуучныг хүчингүй болгоно.

Таны хэрэглээ

Нэвтэрсэн үед энэ хуудсан дээр token болон search хэрэглээг харна уу.

-- API Calls

-- Tokens Used

Shannon API

Тойм

Чадварууд

Drop-in Replacement

Функц дуудах

Вэб хайлт

Бүтэцтэй гаралт

Multi-turn Tools

Дамжуулалт

Түргэн эхлэх

Base URL тохируул

API түлхүүр нэмэх

Анхны мессеж илгээх

Response format

API Playground

Chat, Responses, Messages

Stream live output

Reuse your key

Баталгаажуулалт

OpenAI Format (Recommended)

Anthropic

Моделууд

Функц дуудлага

Функц дуудлага

Response format

Бүтэцтэй гаралт

Response format

Дамжуулалт

Вэб хайлт

Anthropic

SDK-ууд

OpenAI-Compatible SDKs

Anthropic-Compatible SDKs

Алдаа боловсруулах

Error Response Format

Өөрчлөлтийн жагсаалт

Таны API түлхүүр

Таны хэрэглээ

Shannon Coder (shannon-coder-1)

Бүтээхэд бэлэн үү?

Shannon AI API Documentation

Тойм

Чадварууд

Drop-in Replacement

Функц дуудах

Вэб хайлт

Бүтэцтэй гаралт

Multi-turn Tools

Дамжуулалт

Түргэн эхлэх

Base URL тохируул

API түлхүүр нэмэх

Анхны мессеж илгээх

Response format

API Playground

Chat, Responses, Messages

Stream live output

Reuse your key

Баталгаажуулалт

OpenAI Format (Recommended)

Anthropic

Моделууд

Функц дуудлага

Функц дуудлага

Response format

Бүтэцтэй гаралт

Response format

Дамжуулалт

Вэб хайлт

Anthropic

SDK-ууд

OpenAI-Compatible SDKs

Anthropic-Compatible SDKs

Алдаа боловсруулах

Error Response Format

Өөрчлөлтийн жагсаалт

Таны API түлхүүр

Таны хэрэглээ

Shannon Coder (shannon-coder-1)

Бүтээхэд бэлэн үү?