Shannon AI API Dokumentazioa

Ikuspegi orokorra

Public docs

Shannonek OpenAI eta Anthropic bateragarri duen APIarekin bidaltzeko behar duzun guztia.

URL OpenAI-Compatible

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

Use the Chat Completions API with function calling and streaming.

URL Anthropic-Compatible

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

Claude Messages format with tools and anthropic-version header.

HTTP Autentifikazioa

Authorization: Bearer <api-key>

Or X-API-Key with anthropic-version for Claude-style calls.

Access Status

Public docs - Key required to call

Streaming, function calling, structured outputs, web search.

Launch checklist

+

Point your SDK at Shannon

Set baseURL to the OpenAI or Anthropic endpoints above.

Setup
+

Attach your API key

Use Bearer tokens for OpenAI calls or X-API-Key + anthropic-version.

Security
+

Enable tools & structured outputs

Supports OpenAI tools/functions, JSON schema, and built-in web_search.

Gaitasunak
+

Track usage

View token and search consumption on this page when signed in to your account.

Analytics

Gaitasunak

OpenAI + Anthropic

OpenAI eta Anthropic APIen drop‑in ordezkapena, tresnen, irteera egituratuen eta web bilaketa integratuaren laguntzarekin.

Drop‑in ordezkapena

Bateragarria

OpenAI eta Anthropic SDK‑ekin funtzionatzen du. Oinarrizko URL‑a aldatu besterik ez.

Funtzio‑deia

Tresnak

Tresnak definitu eta Shannon‑ek deitu ditzala. auto, forced eta none moduak onartzen ditu.

Web bilaketa txertatua

Bilatu

Denbora errealeko web bilaketa iturri‑aipamenekin. Automatikoki eskuragarri.

Irteera egituratuak

JSON

JSON modua eta JSON Schema derrigortzea datu‑erauzketa fidagarrirako.

Txanda anitzeko tresnak

Agentea

Funtzio‑exekuzio ziklo automatikoak. Gehienez 10 iterazio eskaerako.

Streaminga

Azkar

Server‑sent events token‑streaming denbora errealean.

Hasiera azkarra

5 minutu

Hiru urratsetan hasi. Shannon OpenAI eta Anthropic bezeroak islatzen ditu.

Ezarri oinarrizko URL‑a

Erabili OpenAI‑rekin bateragarria den endpointa.

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

Gehitu zure API key‑a

Erabili Bearer auth Authorization goiburuan.

Bidali zure lehen mezua

Hautatu hizkuntza eta sartu zure gakoa.

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

Erantzun‑formatua

Arrakastazko erantzuna

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

Berria

Probatu Shannon APIa zuzenean nabigatzailean. Eraiki eskaera, exekutatu eta ikusi erantzuna denbora errealean.

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.

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

Probatu Playground V2 Lortu zure API giltza

Autentifikazioa

API eskaera guztiek Shannon API gakoa erabiliz autentifikazioa eskatzen dute.

OpenAI Format (Recommended)

HTTP

Authorization: Bearer YOUR_API_KEY

Anthropic

HTTP

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

Ereduak

Shannonek erabilera‑kasu desberdinetarako optimizatutako hainbat modelo eskaintzen ditu.

shannon-1.6-lite Shannon 1.6 Lite

Fast, efficient responses for everyday tasks

Testuingurua 128K

Segurtasun Profesionalentzat Eraikia Chat, Q&A, Content Generation

shannon-1.6-pro Shannon 1.6 Pro

Advanced reasoning for complex problems

Testuingurua 128K

Segurtasun Profesionalentzat Eraikia Analysis, Research, Complex Tasks

shannon-2-lite Shannon 2 Lite

Testuingurua 128K

Segurtasun Profesionalentzat Eraikia

shannon-2-pro Shannon 2 Pro

Testuingurua 128K

Segurtasun Profesionalentzat Eraikia

shannon-coder-1 Shannon Coder

Optimized for Claude Code CLI with call-based quota

Testuingurua 128K

Segurtasun Profesionalentzat Eraikia Code Generation, Tool Use, CLI Integration

Call-based quota

Funtzio-deiak

Definitu Shannon-ek ekintzak egiteko edo informazioa berreskuratzeko deitu ditzakeen tresnak.

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

Funtzio-deiak

"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

Erantzun‑formatua

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

Irteera egituratuak

Behartu Shannon zure eskemarekin bat datorren JSON baliozkoa ematera.

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

Erantzun‑formatua

{"type": "json_object"} Force valid JSON output (no specific schema)

{"type": "json_schema", "json_schema": {...}} Force output matching your exact schema

Streaminga

Gaitu denbora errealeko token streaming-a Server‑Sent Events bidez UI erantzunkorretarako.

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

Tip: Streaming responses arrive as Server-Sent Events. Each chunk contains a delta with partial content.

Web bilaketa

Shannonek automatikoki erabilgarri dagoen web_search funtzio integratua dauka.

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

Aholkua: Web search results include citations. Shannon will automatically cite sources.

Anthropic

Shannonek Anthropic Messages API formatua ere onartzen du.

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

SDKak

Bateragarria

Erabili edozein OpenAI edo Anthropic SDK — base URL-a bakarrik aldatu.

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

Errore‑kudeaketa

Shannonek HTTP egoera‑kode estandarrak erabiltzen ditu eta errore zehatzak itzultzen ditu.

400 Eskaera okerra Eskaera‑formatu edo parametro okerrak

401 Baimenik gabe API key baliogabea edo falta

402 Kuota gainditua Token edo bilaketa kuota gainditua

429 Muga‑tasa Eskaera gehiegi, moteldu

500 Zerbitzari‑errorea Barne‑errorea, saiatu geroago

Errore‑erantzun formatua

Errore‑erantzuna

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

Aldaketen erregistroa

LOG

Shannon API‑ren azken eguneratzeak eta hobekuntzak.

v2.1.0

2025-01-03

Berria Added shannon-coder-1 model for Claude Code CLI integration
Berria Call-based quota system for Coder model
Improved Improved function calling reliability

v2.0.0

2024-12-15

Berria Added Anthropic Messages API compatibility
Berria Multi-turn tool execution (up to 10 iterations)
Berria JSON Schema response format support
Improved Enhanced web search with better citations

v1.5.0

2024-11-20

Berria Added shannon-deep-dapo model for complex reasoning
Berria Built-in web_search function
Improved Reduced latency for streaming responses

v1.0.0

2024-10-01

Berria Initial API release
Berria OpenAI-compatible chat completions endpoint
Berria Function calling support
Berria Streaming via Server-Sent Events

Zure API key‑a

Access

Use Bearer tokens for OpenAI calls or X-API-Key + anthropic-version.

YOUR_API_KEY

Lortu zure API giltza

Gorde API key‑a sekretuan. Birsortzeak gako berria sortu eta zaharra baliogabetzen du.

Zure erabilera

View token and search consumption on this page when signed in to your account.

-- API deialdiak

-- Erabilitako tokenak

Shannon API

Ikuspegi orokorra

Gaitasunak

Drop‑in ordezkapena

Funtzio‑deia

Web bilaketa txertatua

Irteera egituratuak

Txanda anitzeko tresnak

Streaminga

Hasiera azkarra

Ezarri oinarrizko URL‑a

Gehitu zure API key‑a

Bidali zure lehen mezua

Erantzun‑formatua

API jolasgunea

Chat, Responses, Messages

Stream live output

Reuse your key

Autentifikazioa

OpenAI Format (Recommended)

Anthropic

Ereduak

Funtzio-deiak

Funtzio-deiak

Erantzun‑formatua

Irteera egituratuak

Erantzun‑formatua

Streaminga

Web bilaketa

Anthropic

SDKak

OpenAI-Compatible SDKs

Anthropic-Compatible SDKs

Errore‑kudeaketa

Errore‑erantzun formatua

Aldaketen erregistroa

Zure API key‑a

Zure erabilera

Shannon Coder (shannon-coder-1)

Prest eraikitzeko?

Shannon AI API Documentation

Ikuspegi orokorra

Gaitasunak

Drop‑in ordezkapena

Funtzio‑deia

Web bilaketa txertatua

Irteera egituratuak

Txanda anitzeko tresnak

Streaminga

Hasiera azkarra

Ezarri oinarrizko URL‑a

Gehitu zure API key‑a

Bidali zure lehen mezua

Erantzun‑formatua

API jolasgunea

Chat, Responses, Messages

Stream live output

Reuse your key

Autentifikazioa

OpenAI Format (Recommended)

Anthropic

Ereduak

Funtzio-deiak

Funtzio-deiak

Erantzun‑formatua

Irteera egituratuak

Erantzun‑formatua

Streaminga

Web bilaketa

Anthropic

SDKak

OpenAI-Compatible SDKs

Anthropic-Compatible SDKs

Errore‑kudeaketa

Errore‑erantzun formatua

Aldaketen erregistroa

Zure API key‑a

Zure erabilera

Shannon Coder (shannon-coder-1)

Prest eraikitzeko?