Τεκμηρίωση API Shannon AI

Επισκόπηση

Δημόσια έγγραφα

Όλα όσα χρειάζεσαι για κυκλοφορία με το συμβατό με OpenAI/Anthropic API της Shannon.

Βασικό 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 και header anthropic-version.

Κεφαλίδες Ταυτοποίηση

Εξουσιοδότηση: Bearer <to-kleidi-sou>

Ή χρησιμοποιήστε X-API-Key + anthropic-version για κλήσεις τύπου Claude.

Access Status

Public docs - Key required to call

Streaming, function calling, δομημένες αποκρίσεις και web search.

Λίστα ελέγχου εκκίνησης

+

Συνδέστε το SDK σας στο Shannon

Ορίστε το baseURL στο endpoint OpenAI ή Anthropic παραπάνω.

Setup
+

Προσθέστε το API key σας

Χρησιμοποιήστε Bearer για OpenAI ή X-API-Key + anthropic-version.

Security
+

Ενεργοποιήστε tools και δομημένες αποκρίσεις

Υποστηρίζει OpenAI tools/functions, JSON schema και ενσωματωμένο web_search.

Δυνατότητες
+

Παρακολούθηση χρήσης

Δείτε κατανάλωση token και αναζητήσεων σε αυτή τη σελίδα μετά τη σύνδεση.

Analytics

Δυνατότητες

OpenAI + Anthropic

Άμεση αντικατάσταση για OpenAI και Anthropic APIs με native υποστήριξη για tools, δομημένες αποκρίσεις και ενσωματωμένο web search.

Αντικατάσταση drop‑in

Συμβατό

Λειτουργεί με SDK των OpenAI και Anthropic. Απλώς αλλάξτε το βασικό URL.

Κλήση συναρτήσεων

Εργαλεία

Ορίστε εργαλεία και αφήστε το Shannon να τα καλέσει. Υποστηρίζει τις λειτουργίες auto, forced και none.

Ενσωματωμένη αναζήτηση ιστού

Αναζήτηση

Αναζήτηση ιστού σε πραγματικό χρόνο με παραπομπές πηγών. Διαθέσιμη αυτόματα.

Δομημένες έξοδοι

JSON

Λειτουργία JSON και επιβολή JSON Schema για αξιόπιστη εξαγωγή δεδομένων.

Εργαλεία πολλαπλών γύρων

Πρακτορικό

Αυτόματοι βρόχοι εκτέλεσης συναρτήσεων. Έως 10 επαναλήψεις ανά αίτημα.

Ροή

Γρήγορο

Server‑sent events για ροή token σε πραγματικό χρόνο.

Γρήγορη εκκίνηση

5 λεπτά

Ξεκινήστε σε τρία βήματα. Το Shannon αντικατοπτρίζει πελάτες OpenAI και Anthropic.

Ορίστε το βασικό URL

Χρησιμοποιήστε endpoint συμβατό με OpenAI.

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

Προσθέστε το API key σας

Χρησιμοποιήστε Bearer auth στην κεφαλίδα 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.

/el/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 requests απαιτούν authentication με το 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 προσφέρει πολλαπλά μοντέλα βελτιστοποιημένα για διαφορετικά use cases.

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

Επαγγελματική συμβουλή: Τα αποτελέσματα web search περιλαμβάνουν παραπομπές. Το Shannon παραθέτει πηγές αυτόματα.

Μορφή Anthropic

Το Shannon υποστηρίζει επίσης το Anthropic Messages API format.

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.

SDKs

Συμβατό

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 key

402 Υπέρβαση ορίου Υπέρβαση ορίου token ή αναζήτησης

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 key σας

Access

Χρησιμοποιήστε Bearer για OpenAI ή X-API-Key + anthropic-version.

YOUR_API_KEY

Λήψη API κλειδιού

Κρατήστε το API key μυστικό. Η ανανέωση δημιουργεί νέο κλειδί και ακυρώνει το παλιό.

Η χρήση σας

Δείτε κατανάλωση token και αναζητήσεων σε αυτή τη σελίδα μετά τη σύνδεση.

-- Κλήσεις API

-- Tokens που χρησιμοποιήθηκαν

API Shannon

Επισκόπηση

Δυνατότητες

Αντικατάσταση drop‑in

Κλήση συναρτήσεων

Ενσωματωμένη αναζήτηση ιστού

Δομημένες έξοδοι

Εργαλεία πολλαπλών γύρων

Ροή

Γρήγορη εκκίνηση

Ορίστε το βασικό URL

Προσθέστε το API key σας

Στείλτε το πρώτο σας μήνυμα

Μορφή απόκρισης

Παιδότοπος API

Chat, Responses, Messages

Stream live output

Reuse your key

Ταυτοποίηση

OpenAI Format (Recommended)

Μορφή Anthropic

Μοντέλα

Κλήση συναρτήσεων

Επιλογές επιλογής εργαλείου

Απόκριση κλήσης συνάρτησης

Δομημένες έξοδοι

Επιλογές μορφής απόκρισης

Ροή

Ενσωματωμένη αναζήτηση ιστού

Μορφή Anthropic

SDKs

OpenAI-Compatible SDKs

Anthropic-Compatible SDKs

Χειρισμός σφαλμάτων

Μορφή απόκρισης σφάλματος

Καταγραφή αλλαγών

Το API key σας

Η χρήση σας

Shannon Coder (shannon-coder-1)

Έτοιμοι να χτίσετε;

Shannon AI API Documentation

Επισκόπηση

Δυνατότητες

Αντικατάσταση drop‑in

Κλήση συναρτήσεων

Ενσωματωμένη αναζήτηση ιστού

Δομημένες έξοδοι

Εργαλεία πολλαπλών γύρων

Ροή

Γρήγορη εκκίνηση

Ορίστε το βασικό URL

Προσθέστε το API key σας

Στείλτε το πρώτο σας μήνυμα

Μορφή απόκρισης

Παιδότοπος API

Chat, Responses, Messages

Stream live output

Reuse your key

Ταυτοποίηση

OpenAI Format (Recommended)

Μορφή Anthropic

Μοντέλα

Κλήση συναρτήσεων

Επιλογές επιλογής εργαλείου

Απόκριση κλήσης συνάρτησης

Δομημένες έξοδοι

Επιλογές μορφής απόκρισης

Ροή

Ενσωματωμένη αναζήτηση ιστού

Μορφή Anthropic

SDKs

OpenAI-Compatible SDKs

Anthropic-Compatible SDKs

Χειρισμός σφαλμάτων

Μορφή απόκρισης σφάλματος

Καταγραφή αλλαγών

Το API key σας

Η χρήση σας

Shannon Coder (shannon-coder-1)

Έτοιμοι να χτίσετε;