Логотипи SHANNON A.I.
SHANNONA.I.
ЧатНархномаAPIТадқиқотШиркатPentest AIStartup Boost

Интерфейси Shannon боргирӣ мешавад...

Санҷиши ҳолат...
Ҳуҷҷатҳои API

Shannon API

API-и AI-и мувофиқи OpenAI ва Anthropic бо function calling, web search ва structured outputs.

Калиди API-и худро гиредPlayground-ро санҷедV2
Ҳуҷҷатҳо
  • Шарҳ
  • Имконот
  • Оғози зуд
  • API PlaygroundНав
  • Аутентификатсия
  • Моделҳо
  • Даъвати функсия
  • Баромадҳои сохторӣ
  • Стриминг
  • Ҷустуҷӯи веб
  • Anthropic
  • SDKҳо
  • Идораи хатогиҳо
  • Тағйирот

Shannon AI API Documentation

Шарҳ

Ҳуҷҷатҳои умумӣ

Ҳама чиз барои оғоз бо API-и мувофиқи OpenAI ва Anthropic-и Shannon.

URLМувофиқи OpenAI
https://us-central1-shannonai.cloudfunctions.net/v1/chat/completions

Chat Completions API-ро бо function calling ва streaming истифода баред.

URLМувофиқи Anthropic
https://us-central1-shannonai.cloudfunctions.net/v1/messages

Формати Claude Messages бо tools ва header-и anthropic-version.

HTTPАутентификатсия
Authorization: Bearer <api-key>

Ё X-API-Key бо anthropic-version барои даъватҳои Claude style.

ДастрасӣҲолат
Ҳуҷҷатҳои умумӣ - барои call кардан калид лозим

Streaming, function calling, structured outputs, web search.

Рӯйхати оғоз
  • ✓
    SDK-ро ба Shannon равона кунед
    baseURL-ро ба endpoint-и OpenAI ё Anthropic боло муқаррар кунед.
    Танзим
  • ✓
    Калиди API-ро пайваст кунед
    Барои OpenAI calls Bearer token ё X-API-Key + anthropic-version истифода баред.
    Амният
  • ✓
    Tools ва structured outputs-ро фаъол кунед
    OpenAI tools/functions, JSON schema ва built-in web_search-ро дастгирӣ мекунад.
    Имконот
  • ✓
    Истифодаро пайгирӣ кунед
    Ҳангоми воридшавӣ дар ин саҳифа истифодаи token ва search-ро бинед.
    Аналитика

Имконот

OpenAI + Anthropic

Drop-in replacement барои OpenAI ва Anthropic API; tools, structured outputs ва built-in web search дастгирӣ мешавад.

Drop-in replacement

Мувофиқ

Бо OpenAI ва Anthropic SDK кор мекунад. Танҳо base URL-ро иваз кунед.

Даъвати функсия

Tools

Tools-ро муайян кунед, ба Shannon иҷозат диҳед, ки онҳоро даъват кунад. auto, forced, none режимҳо дастгирӣ мешаванд.

Ҷустуҷӯи веб

Ҷустуҷӯ

Веб ҷустуҷӯи вақти воқеӣ бо cited sources. Автоматӣ дастрас аст.

Баромадҳои сохторӣ

JSON

JSON mode ва JSON Schema enforce барои extraction-и боэътимод.

Multi-turn Tools

Agentic

Function execution loops-и автоматӣ. То 10 iteration барои ҳар request.

Стриминг

Fast

Server-sent events барои real-time token streaming.

Оғози зуд

5 дақиқа

Дар се қадам оғоз кунед. Shannon OpenAI ва Anthropic clients-ро инъикос мекунад.

1

Base URL-ро муқаррар кунед

Endpoint-и OpenAI-compatible-ро истифода баред.

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

Калиди API илова кунед

Дар Authorization header Bearer auth истифода баред.

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)

Response format

Success Response
{
  "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
  }
}

API 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 request-ҳо бо калиди Shannon API аутентификатсия мешаванд.

OpenAI Format (тавсия)

HTTP
Authorization: Bearer YOUR_API_KEY

Anthropic

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

Моделҳо

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

shannon-balanced-grpoBalanced

Ҷавобҳои зуд ва самаранок барои корҳои ҳаррӯза

Контекст128K
Барои мутахассисони амният сохта шудаастЧат, Саволу ҷавоб, Эҷоди мундариҷа
shannon-deep-dapoDeep

Разумгардонии пешрафта барои масъалаҳои мураккаб

Контекст128K
Барои мутахассисони амният сохта шудаастТаҳлил, Тадқиқот, Корҳои мураккаб
shannon-coder-1Coder

Барои Claude Code CLI бо call-based quota оптимизатсия шудааст

Контекст128K
Барои мутахассисони амният сохта шудаастЭҷоди код, Истифодаи tools, CLI интегратсия
Call-based quota

Даъвати функсия

Tools-ро муайян кунед, ки 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"Модел худаш қарор медиҳад, function-ро даъват кунад ё не (default)
"none"Function calling-ро барои ин request хомӯш кунед
{"type": "function", "function": {"name": "..."}}Function-ро маҷбурӣ даъват кунед

Response format

Вақте ки модел 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"
    }
  ]
}

Баромадҳои сохторӣ

Shannon-ро маҷбур кунед, JSON-и дуруст мувофиқи schema-и шумо баргардонад.

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

Response format

{"type": "json_object"}Valid JSON output-ро маҷбур кунед (бе schema-и мушаххас)
{"type": "json_schema", "json_schema": {...}}Output-и мувофиқи schema-и дақиқи шумо

Стриминг

Барои UI-и вокунишгар Server-Sent Events бо real-time token streaming фаъол кунед.

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)
Маслиҳат: Streaming responses ҳамчун Server-Sent Events меоянд. Ҳар chunk delta-и мундариҷаи қисмӣ дорад.

Ҷустуҷӯи веб

Shannon дорои function-и 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
Maslihat: Натиҷаҳои web search бо 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)
Required: Anthropic format ба anthropic-version: 2023-06-01 ниёз дорад.

SDKҳо

Мувофиқ

Ҳар гуна OpenAI ё Anthropic SDK-ро истифода баред — танҳо base URL-ро иваз кунед.

OpenAI-Compatible SDKs

Python

Official OpenAI Python SDK — бо Shannon кор мекунад

pip install openai
Ҳуҷҷатҳоро бинед
JavaScript / TypeScript

Official OpenAI Node.js SDK — бо Shannon кор мекунад

npm install openai
Ҳуҷҷатҳоро бинед
Go

Community Go client барои OpenAI-compatible API

go get github.com/sashabaranov/go-openai
Ҳуҷҷатҳоро бинед
Ruby

Community Ruby client барои OpenAI-compatible API

gem install ruby-openai
Ҳуҷҷатҳоро бинед
PHP

Community PHP client барои OpenAI-compatible API

composer require openai-php/client
Ҳуҷҷатҳоро бинед
Rust

Async Rust client барои OpenAI-compatible API

cargo add async-openai
Ҳуҷҷатҳоро бинед

Anthropic-Compatible SDKs

Python (Anthropic)

Official Anthropic Python SDK — бо Shannon кор мекунад

pip install anthropic
Ҳуҷҷатҳоро бинед
TypeScript (Anthropic)

Official Anthropic TypeScript SDK — бо Shannon кор мекунад

npm install @anthropic-ai/sdk
Ҳуҷҷатҳоро бинед

Идораи хатогиҳо

Shannon стандартҳои HTTP status code-ро истифода мебарад ва хатогиҳои муфассал бармегардонад.

400Bad RequestФормати дархост ё параметрҳо нодурустанд
401UnauthorizedКалиди API нодуруст ё нест
402Quota ExceededToken ё search quota аз ҳад гузашт
429Rate LimitedДархостҳои зиёде, камтар кунед
500Server ErrorХатои дохилӣ, дертар кӯшиш кунед

Error Response Format

Error Response
{
  "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 илова шуд
  • НавСистемаи quota-и call-based барои модели Coder
  • БеҳбудЭътимоднокии function calling беҳтар шуд
v2.0.0
2024-12-15
  • НавМутобиқати Anthropic Messages API илова шуд
  • НавИҷрои multi-turn tool (то 10 iterations)
  • НавДастгирии JSON Schema response format
  • БеҳбудWeb search бо citations беҳтар шуд
v1.5.0
2024-11-20
  • НавМодели shannon-deep-dapo барои reasoning-и мураккаб илова шуд
  • НавFunction-и built-in web_search
  • БеҳбудКам шудани latency-и streaming responses
v1.0.0
2024-10-01
  • НавНашри аввали API
  • НавOpenAI-compatible chat completions endpoint
  • НавДастгирии function calling
  • НавStreaming тавассути Server-Sent Events

Омодаи сохтани он ҳастед?

Калиди API-и худро гиред ва имрӯз бо Shannon AI оғоз кунед.

Калиди API гиредНархҳоро бинед