Antontan-taratasy API Shannon AI

Topimaso

Antontan-taratasy ho an'ny rehetra

Ny zavatra rehetra ilainao hanombohana amin'ny API mifanaraka amin'ny OpenAI sy Anthropic an'i Shannon.

URL OpenAI-Compatible

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

Ampiasao ny Chat Completions API miaraka amin'ny function calling sy streaming.

URL Anthropic-Compatible

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

Claude Messages format miaraka amin'ny tools sy anthropic-version header.

HTTP Fanamarinana

Authorization: Bearer <api-key>

Na X-API-Key miaraka amin'ny anthropic-version ho an'ny Claude style calls.

Fidirana Sata

Antontan-taratasy ho an'ny rehetra - mila key raha te hiantso

Streaming, function calling, structured outputs, web search.

Lisitra fanombohana

+

Tondroy ny SDK ho any Shannon

Apetraho ny baseURL amin'ny OpenAI na Anthropic endpoints etsy ambony.

Fametrahana
+

Ampifandraiso ny API key-nao

Ampiasao Bearer tokens ho an'ny OpenAI calls na X-API-Key + anthropic-version.

Fiarovana
+

Atsangano ny tools sy structured outputs

Manohana OpenAI tools/functions, JSON schema ary built-in web_search.

Fahaiza-manao
+

Araho ny fampiasana

Rehefa miditra ianao dia afaka mahita token sy search usage eto amin'ity pejy ity.

Fanadihadiana

Fahaiza-manao

OpenAI + Anthropic

Drop-in replacement ho an'ny OpenAI sy Anthropic APIs; manohana tools, structured outputs, ary built-in web search.

Drop-in Replacement

Compatible

Miasa amin'ny OpenAI sy Anthropic SDKs. Ovay fotsiny ny base URL.

Fiantsoana asa

Tools

Farito ny tools, avelao i Shannon hiantso azy. Manohana auto, forced, none.

Fikarohana web

Tadiavo

Web search amin'ny fotoana tena izy miaraka amin'ny citations. Azo ampiasaina ho azy.

Vokatra voarafitra

JSON

JSON mode sy JSON Schema enforcement ho an'ny famoahana data azo itokisana.

Multi-turn Tools

Agentic

Automatic function execution loops. Hatrany amin'ny 10 iterations isaky ny request.

Fandefasana mivantana

Fast

Server-sent events ho an'ny real-time token streaming.

Fanombohana haingana

5 minitra

Manomboka amin'ny dingana 3. Shannon dia manahaka ny OpenAI sy Anthropic clients.

Apetraka ny Base URL

Ampiasao ny OpenAI-compatible endpoint.

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

Ampio ny API key

Ampiasao Bearer auth ao amin'ny Authorization header.

Alefaso ny hafatra voalohany

Safidio ny fiteny ary ovao ny key-nao.

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

Vaovao

Andramo mivantana ao amin'ny navigateur ny Shannon API. Mamoròna ny fangatahana, alefaso, ary jereo avy hatrany ny valiny.

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.

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

Andramo ny Playground V2 Makà API key

Fanamarinana

Ny API requests rehetra dia mila fanamarinana amin'ny 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

Modely

Shannon dia manolotra modely maromaro voaomana ho an'ny fampiasana isan-karazany.

shannon-1.6-lite Shannon 1.6 Lite

Valiny haingana sy mahomby ho an'ny asa andavanandro

Toe-javatra 128K

Natao ho an'ny Matihanina Fiarovana Chat, Q&A, Content Generation

shannon-1.6-pro Shannon 1.6 Pro

Reasoning mandroso ho an'ny olana sarotra

Toe-javatra 128K

Natao ho an'ny Matihanina Fiarovana Analysis, Research, Complex Tasks

shannon-2-lite Shannon 2 Lite

Toe-javatra 128K

Natao ho an'ny Matihanina Fiarovana

shannon-2-pro Shannon 2 Pro

Toe-javatra 128K

Natao ho an'ny Matihanina Fiarovana

shannon-coder-1 Shannon Coder

Nampifanarahana ho an'ny Claude Code CLI miaraka amin'ny call-based quota

Toe-javatra 128K

Natao ho an'ny Matihanina Fiarovana Code Generation, Tool Use, CLI Integration

Call-based quota

Antso fiasa

Farito ireo tools azon'i Shannon antsoina hanao asa na haka vaovao.

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

Antso fiasa

"auto" Ny modely no manapa-kevitra raha hiantso function (default)

"none" Atsaharo ny function calling ho an'ity request ity

{"type": "function", "function": {"name": "..."}} Terena ny function call manokana

Response format

Rehefa miantso function ny modely

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

Vokatra voarafitra

Ampirisihina i Shannon hamerina JSON marina mifanaraka amin'ny schema-nao.

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"} Terena valid JSON output (tsy misy schema manokana)

{"type": "json_schema", "json_schema": {...}} Terena output mifanaraka amin'ny schema-nao

Fandefasana mivantana

Alefaso ny real-time token streaming amin'ny alalan'ny Server-Sent Events ho an'ny UI mamaly haingana.

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

Soso-kevitra: Streaming responses dia tonga amin'ny Server-Sent Events. Ny chunk tsirairay dia misy delta amin'ny votoaty ampahany.

Fikarohana web

Shannon dia manana web_search function azo ampiasaina ho azy.

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

Soso-kevitra: Ny valin'ny web search dia misy citations. Shannon dia hamoaka loharano ho azy.

Anthropic

Shannon dia manohana ny Anthropic Messages API format ihany koa.

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 dia mila anthropic-version: 2023-06-01.

SDK

Compatible

Ampiasao OpenAI na Anthropic SDK rehetra — ovay fotsiny ny base URL.

OpenAI-Compatible SDKs

SDK Python

Official OpenAI Python SDK — miasa miaraka amin'i Shannon

pip install openai

Jereo ny antontan-taratasy ->

SDK JavaScript / TypeScript

Official OpenAI Node.js SDK — miasa miaraka amin'i Shannon

npm install openai

Jereo ny antontan-taratasy ->

SDK Go

Community Go client ho an'ny OpenAI-compatible APIs

go get github.com/sashabaranov/go-openai

Jereo ny antontan-taratasy ->

SDK Ruby

Community Ruby client ho an'ny OpenAI-compatible APIs

gem install ruby-openai

Jereo ny antontan-taratasy ->

SDK PHP

Community PHP client ho an'ny OpenAI-compatible APIs

composer require openai-php/client

Jereo ny antontan-taratasy ->

SDK Rust

Async Rust client ho an'ny OpenAI-compatible APIs

cargo add async-openai

Jereo ny antontan-taratasy ->

Anthropic-Compatible SDKs

SDK Python (Anthropic)

Official Anthropic Python SDK — miasa miaraka amin'i Shannon

pip install anthropic

Jereo ny antontan-taratasy ->

SDK TypeScript (Anthropic)

Official Anthropic TypeScript SDK — miasa miaraka amin'i Shannon

npm install @anthropic-ai/sdk

Jereo ny antontan-taratasy ->

Fitantanana hadisoana

Shannon dia mampiasa HTTP status codes mahazatra ary mamerina hafatra hadisoana amin'ny antsipiriany.

400 Bad Request Diso ny format na paramètre amin'ny fangatahana

401 Unauthorized API key diso na tsy misy

402 Quota Exceeded Nihoatra ny quota token na search

429 Rate Limited Fangatahana be loatra, ahenoy

500 Server Error Hadisoana anatiny, andramo indray tatỳ aoriana

Error Response Format

Error Response

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

Tatitry ny fanovana

LOG

Fanavaozana sy fanatsarana farany ao amin'ny Shannon API.

v2.1.0

2025-01-03

Vaovao Nampiana ny modely shannon-coder-1 ho an'ny Claude Code CLI integration
Vaovao Call-based quota system ho an'ny modely Coder
Nohatsaraina Nohatsaraina ny fahatokisan'ny function calling

v2.0.0

2024-12-15

Vaovao Nampiana ny Anthropic Messages API compatibility
Vaovao Multi-turn tool execution (hatramin'ny 10 iterations)
Vaovao JSON Schema response format support
Nohatsaraina Nohatsaraina ny web search miaraka amin'ny citations

v1.5.0

2024-11-20

Vaovao Nampiana shannon-deep-dapo ho an'ny reasoning sarotra
Vaovao Built-in web_search function
Nohatsaraina Nihena ny latency amin'ny streaming responses

v1.0.0

2024-10-01

Vaovao Famoahana voalohany ny API
Vaovao OpenAI-compatible chat completions endpoint
Vaovao Function calling support
Vaovao Streaming amin'ny Server-Sent Events

Ny API key-nao

Fidirana

Ampiasao Bearer tokens ho an'ny OpenAI calls na X-API-Key + anthropic-version.

YOUR_API_KEY

Makà API key

Tehirizo ho tsiambaratelo ny API key-nao. Regenerate dia mamorona key vaovao ary manafoana ny taloha.

Ny fampiasanao

Rehefa miditra ianao dia afaka mahita token sy search usage eto amin'ity pejy ity.

-- API Calls

-- Tokens Used

Shannon API

Topimaso

Fahaiza-manao

Drop-in Replacement

Fiantsoana asa

Fikarohana web

Vokatra voarafitra

Multi-turn Tools

Fandefasana mivantana

Fanombohana haingana

Apetraka ny Base URL

Ampio ny API key

Alefaso ny hafatra voalohany

Response format

API Playground

Chat, Responses, Messages

Stream live output

Reuse your key

Fanamarinana

OpenAI Format (Recommended)

Anthropic

Modely

Antso fiasa

Antso fiasa

Response format

Vokatra voarafitra

Response format

Fandefasana mivantana

Fikarohana web

Anthropic

SDK

OpenAI-Compatible SDKs

Anthropic-Compatible SDKs

Fitantanana hadisoana

Error Response Format

Tatitry ny fanovana

Ny API key-nao

Ny fampiasanao

Shannon Coder (shannon-coder-1)

Vonona hanorina ve?

Shannon AI API Documentation

Topimaso

Fahaiza-manao

Drop-in Replacement

Fiantsoana asa

Fikarohana web

Vokatra voarafitra

Multi-turn Tools

Fandefasana mivantana

Fanombohana haingana

Apetraka ny Base URL

Ampio ny API key

Alefaso ny hafatra voalohany

Response format

API Playground

Chat, Responses, Messages

Stream live output

Reuse your key

Fanamarinana

OpenAI Format (Recommended)

Anthropic

Modely

Antso fiasa

Antso fiasa

Response format

Vokatra voarafitra

Response format

Fandefasana mivantana

Fikarohana web

Anthropic

SDK

OpenAI-Compatible SDKs

Anthropic-Compatible SDKs

Fitantanana hadisoana

Error Response Format

Tatitry ny fanovana

Ny API key-nao

Ny fampiasanao

Shannon Coder (shannon-coder-1)

Vonona hanorina ve?