Dokumentacija Shannon AI API-ja

Pregled

Javni dokumenti

Sve što ti treba za lansiranje s Shannon API‑jem kompatibilnim s OpenAI i Anthropic.

URL Kompatibilno s OpenAI-jem

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

Koristite Chat Completions API s pozivanjem funkcija i streamingom.

URL Kompatibilno s Anthropicom

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

Claude Messages format s alatima i zaglavljem anthropic-version.

Zaglavlja Autentikacija

Authorization: Bearer <api-key>

Ili X-API-Key s anthropic-version za pozive u Claude stilu.

Pristup Status

Javni dokumenti - ključ je potreban za poziv

Streaming, pozivanje funkcija, strukturirani izlazi, web pretraga.

Popis za lansiranje

+

Usmjerite svoj SDK na Shannon

Postavite baseURL na OpenAI ili Anthropic endpoints gore.

Postavke
+

Priložite svoj API ključ

Koristite Bearer tokene za OpenAI pozive ili X-API-Key + anthropic-version.

Sigurnost
+

Omogućite alate i strukturirane izlaze

Podržava OpenAI alate/funkcije, JSON schema i ugrađeni web_search.

Mogućnosti
+

Pratite korištenje

Pregledajte potrošnju tokena i pretrage na ovoj stranici kada ste prijavljeni.

Analitika

Mogućnosti

OpenAI + Anthropic

Drop-in zamjena za OpenAI i Anthropic API-je s izvornom podrškom za alate, strukturirane izlaze i ugrađenu web pretragu.

Drop-in zamjena

Kompatibilno

Radi s OpenAI i Anthropic SDK-ovima. Samo promijenite base URL.

Pozivanje funkcija

Alati

Definirajte alate, Shannon ih poziva. Podržava auto, prisilni i none način.

Ugrađena web pretraga

Pretraga

Web pretraga u stvarnom vremenu s citatima izvora. Automatski dostupno.

Strukturirani izlazi

JSON

JSON način i forsiranje JSON Sheme za pouzdano izvlačenje podataka.

Višekratni alati

Agenti

Automatske petlje izvršavanja funkcija. Do 10 iteracija po zahtjevu.

Streaming

Brzo

Server-sent events za streaming tokena u stvarnom vremenu.

Brzi početak

5 minuta

Kreni u tri koraka. Shannon odražava OpenAI i Anthropic klijente.

Postavite svoj base URL

Koristite OpenAI kompatibilni endpoint.

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

Dodajte svoj API ključ

Koristite Bearer autentikaciju u Authorization zaglavlju.

Pošaljite svoju prvu poruku

Odaberite jezik i zamijenite svojim ključem.

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

Format odgovora

Uspješan odgovor

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

Playground

Novo

Testiraj Shannon API direktno u pregledniku. Sastavi zahtjev, pokreni i vidi odgovor u stvarnom vremenu.

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.

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

Isprobaj Playground V2 Nabavi API ključ

Autentikacija

Svi API zahtjevi zahtijevaju autentikaciju pomoću vašeg Shannon API ključa.

OpenAI format (preporučeno)

HTTP

Authorization: Bearer YOUR_API_KEY

Anthropic format

HTTP

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

Modeli

Shannon nudi više modela optimiziranih za različite slučajeve upotrebe.

shannon-1.6-lite Shannon 1.6 Lite

Brzi, učinkoviti odgovori za svakodnevne zadatke

Kontekst 128K

Najbolje za Chat, Pitanja i odgovori, Generiranje sadržaja

shannon-1.6-pro Shannon 1.6 Pro

Napredno rezoniranje za složene probleme

Kontekst 128K

Najbolje za Analiza, Istraživanje, Složeni zadaci

shannon-2-lite Shannon 2 Lite

Kontekst 128K

Najbolje za

shannon-2-pro Shannon 2 Pro

Kontekst 128K

Najbolje za

shannon-coder-1 Shannon Coder

Optimizirano za Claude Code CLI s kvotom po pozivima

Kontekst 128K

Najbolje za Generiranje koda, Korištenje alata, CLI integracija

Kvota po pozivima

Pozivanje funkcija

Definirajte alate koje Shannon može pozvati za izvođenje radnji ili dohvaćanje informacija.

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

Opcije odabira alata

"auto" Model odlučuje hoće li pozvati funkciju (zadano)

"none" Onemogući pozivanje funkcija za ovaj zahtjev

{"type": "function", "function": {"name": "..."}} Prisili poziv određene funkcije

Odgovor poziva funkcije

Kada model pozove funkciju

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

Strukturirani izlazi

Prisili Shannon da odgovori valjanim JSON-om koji odgovara tvojoj shemi.

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

Opcije formata odgovora

{"type": "json_object"} Prisili valjani JSON izlaz (bez specifične sheme)

{"type": "json_schema", "json_schema": {...}} Prisili izlaz koji odgovara tvojoj točnoj shemi

Streaming

Omogućite streaming tokena u stvarnom vremenu s Server-Sent Events za responzivna sučelja.

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

Savjet: Streaming odgovori stižu kao Server-Sent Events. Svaki chunk sadrži delta s djelomičnim sadržajem.

Ugrađena web pretraga

Shannon uključuje ugrađenu web_search funkciju koja je automatski dostupna.

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 savjet: Rezultati web pretrage uključuju citate. Shannon će automatski citirati izvore.

Anthropic format

Shannon također podržava Anthropicov 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);

Obavezno zaglavlje: Anthropic format zahtijeva anthropic-version: 2023-06-01.

SDK

Kompatibilno

Koristite bilo koji OpenAI ili Anthropic SDK – samo promijenite base URL.

OpenAI kompatibilni SDK-ovi

SDK Python

Službeni OpenAI Python SDK - radi sa Shannonom

pip install openai

Pogledaj dokumentaciju ->

SDK JavaScript / TypeScript

Službeni OpenAI Node.js SDK - radi sa Shannonom

npm install openai

Pogledaj dokumentaciju ->

SDK Go

Go klijent zajednice za OpenAI kompatibilne API-je

go get github.com/sashabaranov/go-openai

Pogledaj dokumentaciju ->

SDK Ruby

Ruby klijent zajednice za OpenAI kompatibilne API-je

gem install ruby-openai

Pogledaj dokumentaciju ->

SDK PHP

PHP klijent zajednice za OpenAI kompatibilne API-je

composer require openai-php/client

Pogledaj dokumentaciju ->

SDK Rust

Asinkroni Rust klijent za OpenAI kompatibilne API-je

cargo add async-openai

Pogledaj dokumentaciju ->

Anthropic kompatibilni SDK-ovi

SDK Python (Anthropic)

Službeni Anthropic Python SDK - radi sa Shannonom

pip install anthropic

Pogledaj dokumentaciju ->

SDK TypeScript (Anthropic)

Službeni Anthropic TypeScript SDK - radi sa Shannonom

npm install @anthropic-ai/sdk

Pogledaj dokumentaciju ->

Upravljanje greškama

Shannon koristi standardne HTTP status kodove i vraća detaljne poruke o pogrešci.

400 Neispravan zahtjev Neispravan format zahtjeva ili parametri

401 Neovlašteno Neispravan ili nedostajući API ključ

402 Kvota prekoračena Prekoračena kvota tokena ili pretrage

429 Ograničenje brzine Previše zahtjeva, usporite

500 Greška poslužitelja Interna greška, pokušajte kasnije

Format odgovora o pogrešci

Odgovor o pogrešci

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

Dnevnik promjena

LOG

Nedavna ažuriranja i poboljšanja Shannon API-ja.

v2.1.0

2025-01-03

Novo Dodan shannon-coder-1 model za integraciju s Claude Code CLI-jem
Novo Sustav kvota po pozivima za Coder model
Poboljšano Poboljšana pouzdanost pozivanja funkcija

v2.0.0

2024-12-15

Novo Dodana kompatibilnost s Anthropic Messages API-jem
Novo Izvršavanje alata u više koraka (do 10 iteracija)
Novo Podrška za JSON Schema format odgovora
Poboljšano Poboljšana web pretraga s boljim citatima

v1.5.0

2024-11-20

Novo Dodan shannon-deep-dapo model za složeno rezoniranje
Novo Ugrađena web_search funkcija
Poboljšano Smanjena latencija za streaming odgovore

v1.0.0

2024-10-01

Novo Početno izdanje API-ja
Novo OpenAI kompatibilni chat completions endpoint
Novo Podrška za pozivanje funkcija
Novo Streaming putem Server-Sent Events

Tvoj API ključ

Pristup

Koristite Bearer tokene za OpenAI pozive ili X-API-Key + anthropic-version.

YOUR_API_KEY

Nabavi API ključ

Čuvajte svoj API ključ u tajnosti. Regeneriranje stvara novi ključ i poništava stari.

Tvoja upotreba

Pregledajte potrošnju tokena i pretrage na ovoj stranici kada ste prijavljeni.

-- API pozivi

-- Iskorišteni tokeni

Shannon API

Pregled

Mogućnosti

Drop-in zamjena

Pozivanje funkcija

Ugrađena web pretraga

Strukturirani izlazi

Višekratni alati

Streaming

Brzi početak

Postavite svoj base URL

Dodajte svoj API ključ

Pošaljite svoju prvu poruku

Format odgovora

Playground

Chat, Responses, Messages

Stream live output

Reuse your key

Autentikacija

OpenAI format (preporučeno)

Anthropic format

Modeli

Pozivanje funkcija

Opcije odabira alata

Odgovor poziva funkcije

Strukturirani izlazi

Opcije formata odgovora

Streaming

Ugrađena web pretraga

Anthropic format

SDK

OpenAI kompatibilni SDK-ovi

Anthropic kompatibilni SDK-ovi

Upravljanje greškama

Format odgovora o pogrešci

Dnevnik promjena

Tvoj API ključ

Tvoja upotreba

Shannon Coder (shannon-coder-1)

Spreman za izgradnju?

Shannon AI API Documentation

Pregled

Mogućnosti

Drop-in zamjena

Pozivanje funkcija

Ugrađena web pretraga

Strukturirani izlazi

Višekratni alati

Streaming

Brzi početak

Postavite svoj base URL

Dodajte svoj API ključ

Pošaljite svoju prvu poruku

Format odgovora

Playground

Chat, Responses, Messages

Stream live output

Reuse your key

Autentikacija

OpenAI format (preporučeno)

Anthropic format

Modeli

Pozivanje funkcija

Opcije odabira alata

Odgovor poziva funkcije

Strukturirani izlazi

Opcije formata odgovora

Streaming

Ugrađena web pretraga

Anthropic format

SDK

OpenAI kompatibilni SDK-ovi

Anthropic kompatibilni SDK-ovi

Upravljanje greškama

Format odgovora o pogrešci

Dnevnik promjena

Tvoj API ključ

Tvoja upotreba

Shannon Coder (shannon-coder-1)

Spreman za izgradnju?