Shannon AI API Hujjatlari

Umumiy ko‘rinish

Ochiq hujjatlar

Shannon’ning OpenAI va Anthropic mos API’si bilan ishga tushirish uchun kerak bo‘lgan hamma narsa.

Asosiy URL OpenAI mos

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

Chat Completions API’dan funksiya chaqirish va streaming bilan foydalaning.

Asosiy URL Anthropic mos

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

Claude Messages formati, vositalar va anthropic-version sarlavhasi bilan.

Sarlavhalar Autentifikatsiya

Authorization: Bearer <api-key>

Yoki Claude uslubidagi chaqiriqlar uchun X-API-Key va anthropic-version.

Kirish Status

Ochiq hujjatlar - chaqirish uchun kalit kerak

Streaming, funksiya chaqirish, tuzilgan chiqishlar, veb qidiruv.

Ishga tushirish ro‘yxati

+

SDK’ingizni Shannon’ga yo‘naltiring

baseURL’ni yuqoridagi OpenAI yoki Anthropic endpointlariga sozlang.

Sozlash
+

API kalitingizni ulang

OpenAI chaqiriqlari uchun Bearer tokenlari yoki X-API-Key + anthropic-version dan foydalaning.

Xavfsizlik
+

Vositalar va tuzilgan chiqishlarni yoqing

OpenAI tools/functions, JSON schema va veblashtirilgan web_search ni qo‘llab-quvvatlaydi.

Imkoniyatlar
+

Sarfdan xabardor bo‘ling

Hisobingizga kirganingizda token va qidiruv sarfini shu sahifada ko‘ring.

Analitika

Imkoniyatlar

OpenAI + Anthropic

OpenAI va Anthropic API’lari uchun drop-in almashtirish, vositalar, tuzilgan chiqishlar va o‘rnatilgan veb qidiruvni native qo‘llab-quvvatlaydi.

Drop-in almashtirish

Mos

OpenAI va Anthropic SDK’lari bilan ishlaydi. Faqat asosiy URL’ni o‘zgartiring.

Funksiya chaqirish

Vositalar

Vositalarni belgilang, Shannon ularni chaqirsin. auto, forced va none rejimlarini qo‘llab-quvvatlaydi.

O‘rnatilgan veb qidiruv

Qidiruv

Manbalar bilan real vaqt qidiruvi. Avtomatik mavjud.

Tuzilgan chiqishlar

JSON

JSON rejimi va JSON schema majburiyati ishonchli ma’lumot ajratish uchun.

Ko‘p-bosqichli vositalar

Agentik

Funksiya bajarishning avtomatik sikllari. Har so‘rov uchun 10 ta iteratsiyagacha.

Oqim

Tez

Real vaqt token streaming uchun server-sent events.

Tez boshlash

5 daqiqa

Uch qadamda boshlang. Shannon OpenAI va Anthropic klientlarini aks ettiradi.

Asosiy URL’ni sozlang

OpenAI mos endpoint’dan foydalaning.

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

API kalitini qo‘shing

Authorization sarlavhasida Bearer auth’dan foydalaning.

Birinchi xabaringizni yuboring

Til tanlang va kalitingizni almashtiring.

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

Javob formati

Muvaffaqiyatli javob

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

Yangi

Shannon API’ni bevosita brauzerda sinab ko‘ring. So‘rovni tuzing, ishga tushiring va javobni real vaqtida ko‘ring.

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.

/uz/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.

Playgroundni sinab ko‘ring V2 API kalitingizni olish

Autentifikatsiya

Barcha API so‘rovlari Shannon API kaliti bilan autentifikatsiya talab qiladi.

OpenAI formati (tavsiya etiladi)

HTTP

Authorization: Bearer YOUR_API_KEY

Anthropic formati

HTTP

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

Modellar

Shannon turli foydalanish holatlari uchun optimallashtirilgan bir nechta modelni taklif qiladi.

shannon-1.6-lite Shannon 1.6 Lite

Kundalik vazifalar uchun tez va samarali javoblar

Kontekst 128K

Eng yaxshi Chat, Savol-javob, Kontent yaratish

shannon-1.6-pro Shannon 1.6 Pro

Murakkab muammolar uchun ilg‘or mantiq

Kontekst 128K

Eng yaxshi Tahlil, Tadqiqot, Murakkab vazifalar

shannon-2-lite Shannon 2 Lite

Kontekst 128K

Eng yaxshi

shannon-2-pro Shannon 2 Pro

Kontekst 128K

Eng yaxshi

shannon-coder-1 Shannon Coder

Claude Code CLI uchun chaqiriq kvotasi bilan optimallashtirilgan

Kontekst 128K

Eng yaxshi Kod yaratish, Vosita ishlatish, CLI integratsiya

Chaqiriq bo‘yicha kvota

Funksiya chaqirish

Shannon bajarishi yoki ma’lumot olish uchun chaqira oladigan vositalarni belgilang.

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

Vosita tanlash opsiyalari

"auto" Model funksiya chaqirishni o‘zi hal qiladi (standart)

"none" Bu so‘rov uchun funksiya chaqirishni o‘chiradi

{"type": "function", "function": {"name": "..."}} Muayyan funksiya chaqiruvini majburiy qiling

Funksiya chaqiruvi javobi

Model funksiya chaqirganda

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

Tuzilgan chiqishlar

Shannon’ni sizning sxemangizga mos valid JSON bilan javob berishga majburlang.

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

Javob formati opsiyalari

{"type": "json_object"} Valid JSON chiqishini majburlash (maxsus sxemasiz)

{"type": "json_schema", "json_schema": {...}} Aniq sxemangizga mos chiqishni majburlash

Oqim

Tezkor UI uchun Server-Sent Events bilan real vaqt token streamingni yoqing.

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

Maslahat: Streaming javoblar Server-Sent Events sifatida keladi. Har bir bo‘lak qisman kontentli delta bo‘ladi.

O‘rnatilgan veb qidiruv

Shannon avtomatik mavjud bo‘lgan web_search funksiyasini o‘z ichiga oladi.

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

Pro maslahat: Veb qidiruv natijalari manbalar keltiradi. Shannon avtomatik ravishda manbalarni keltiradi.

Anthropic formati

Shannon Anthropic Messages API formatini ham qo‘llab-quvvatlaydi.

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);

Majburiy sarlavha: Anthropic formati anthropic-version: 2023-06-01 talab qiladi.

SDKlar

Mos

Har qanday OpenAI yoki Anthropic SDK’dan foydalaning — faqat asosiy URL’ni o‘zgartiring.

OpenAI mos SDKlar

SDK Python

Rasmiy OpenAI Python SDK – Shannon bilan ishlaydi

pip install openai

Hujjatlarni ko‘rish ->

SDK JavaScript / TypeScript

Rasmiy OpenAI Node.js SDK – Shannon bilan ishlaydi

npm install openai

Hujjatlarni ko‘rish ->

SDK Go

OpenAI mos API’lar uchun hamjamiyat Go mijoz

go get github.com/sashabaranov/go-openai

Hujjatlarni ko‘rish ->

SDK Ruby

OpenAI mos API’lar uchun hamjamiyat Ruby mijoz

gem install ruby-openai

Hujjatlarni ko‘rish ->

SDK PHP

OpenAI mos API’lar uchun hamjamiyat PHP mijoz

composer require openai-php/client

Hujjatlarni ko‘rish ->

SDK Rust

OpenAI mos API’lar uchun asinxron Rust mijoz

cargo add async-openai

Hujjatlarni ko‘rish ->

Anthropic mos SDKlar

SDK Python (Anthropic)

Rasmiy Anthropic Python SDK – Shannon bilan ishlaydi

pip install anthropic

Hujjatlarni ko‘rish ->

SDK TypeScript (Anthropic)

Rasmiy Anthropic TypeScript SDK – Shannon bilan ishlaydi

npm install @anthropic-ai/sdk

Hujjatlarni ko‘rish ->

Xatolarni boshqarish

Shannon standart HTTP status kodlaridan foydalanadi va batafsil xato xabarlarini qaytaradi.

400 Noto‘g‘ri so‘rov So‘rov formati yoki parametrlari noto‘g‘ri

401 Ruxsatsiz API kaliti noto‘g‘ri yoki yo‘q

402 Kvota oshib ketdi Token yoki qidiruv kvotasi oshib ketdi

429 Tezlik cheklovi Juda ko‘p so‘rov, sekinlashtiring

500 Server xatosi Ichki xato, keyinroq urinib ko‘ring

Xato javobi formati

Xato javobi

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

O‘zgarishlar jurnali

LOG

Shannon API’dagi so‘nggi yangilanish va yaxshilanishlar.

v2.1.0

2025-01-03

Yangi Claude Code CLI integratsiyasi uchun shannon-coder-1 modeli qo‘shildi
Yangi Coder modeli uchun chaqiriq bo‘yicha kvota tizimi
Yaxshilangan Funksiya chaqirish ishonchliligi yaxshilandi

v2.0.0

2024-12-15

Yangi Anthropic Messages API mosligi qo‘shildi
Yangi Ko‘p-bosqichli vosita bajarilishi (10 iteratsiyagacha)
Yangi JSON Schema javob formati qo‘llab-quvvatlovi
Yaxshilangan Yaxshiroq iqtiboslar bilan veb qidiruv kuchaytirildi

v1.5.0

2024-11-20

Yangi Murakkab mantiq uchun shannon-deep-dapo modeli qo‘shildi
Yangi O‘rnatilgan web_search funksiyasi
Yaxshilangan Streaming javoblar uchun kechikish kamaytirildi

v1.0.0

2024-10-01

Yangi APIning boshlang‘ich relizi
Yangi OpenAI mos chat completions endpoint
Yangi Funksiya chaqirish qo‘llab-quvvatlovi
Yangi Server-Sent Events orqali streaming

API kalitingiz

Kirish

OpenAI chaqiriqlari uchun Bearer tokenlari yoki X-API-Key + anthropic-version dan foydalaning.

YOUR_API_KEY

API kalitingizni olish

API kalitingizni sir saqlang. Qayta yaratish yangi kalit yaratadi va eski kalitni bekor qiladi.

Sizning sarfingiz

Hisobingizga kirganingizda token va qidiruv sarfini shu sahifada ko‘ring.

-- API chaqiriqlari

-- Ishlatilgan tokenlar

Shannon API

Umumiy ko‘rinish

Imkoniyatlar

Drop-in almashtirish

Funksiya chaqirish

O‘rnatilgan veb qidiruv

Tuzilgan chiqishlar

Ko‘p-bosqichli vositalar

Oqim

Tez boshlash

Asosiy URL’ni sozlang

API kalitini qo‘shing

Birinchi xabaringizni yuboring

Javob formati

API Playground

Chat, Responses, Messages

Stream live output

Reuse your key

Autentifikatsiya

OpenAI formati (tavsiya etiladi)

Anthropic formati

Modellar

Funksiya chaqirish

Vosita tanlash opsiyalari

Funksiya chaqiruvi javobi

Tuzilgan chiqishlar

Javob formati opsiyalari

Oqim

O‘rnatilgan veb qidiruv

Anthropic formati

SDKlar

OpenAI mos SDKlar

Anthropic mos SDKlar

Xatolarni boshqarish

Xato javobi formati

O‘zgarishlar jurnali

API kalitingiz

Sizning sarfingiz

Shannon Coder (shannon-coder-1)

Qurishga tayyormisiz?

Shannon AI API Documentation

Umumiy ko‘rinish

Imkoniyatlar

Drop-in almashtirish

Funksiya chaqirish

O‘rnatilgan veb qidiruv

Tuzilgan chiqishlar

Ko‘p-bosqichli vositalar

Oqim

Tez boshlash

Asosiy URL’ni sozlang

API kalitini qo‘shing

Birinchi xabaringizni yuboring

Javob formati

API Playground

Chat, Responses, Messages

Stream live output

Reuse your key

Autentifikatsiya

OpenAI formati (tavsiya etiladi)

Anthropic formati

Modellar

Funksiya chaqirish

Vosita tanlash opsiyalari

Funksiya chaqiruvi javobi

Tuzilgan chiqishlar

Javob formati opsiyalari

Oqim

O‘rnatilgan veb qidiruv

Anthropic formati

SDKlar

OpenAI mos SDKlar

Anthropic mos SDKlar

Xatolarni boshqarish

Xato javobi formati

O‘zgarishlar jurnali

API kalitingiz

Sizning sarfingiz

Shannon Coder (shannon-coder-1)

Qurishga tayyormisiz?