Shannon AI Sgrìobhainnean API

Ro-shealladh

Sgrìobhainnean poblach

A h-uile dad a dh’ fheumas tu a chuir air falbh le Shannon's OpenAI agus API co-fhreagarrach Anthropic.

URL bunaiteach Co-chòrdail ri OpenAI

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

Cleachd an Chat Compmpletions API le gairm gnìomh agus sruthadh.

URL bunaiteach Antropic-Co-fhreagarrach

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

Cruth Claude Messages le innealan agus bann-cinn dreach anthropic.

Cinn-cinn Dearbhadh

Ùghdarrachadh: Neach-giùlain <your-key>

No X-API-Key le dreach anthropic airson gairmean ann an stoidhle Claude.

Ruigsinneachd Inbhe

Docs poblach - Tha feum air iuchair airson fònadh

Sruthadh, gairm gnìomh, toraidhean structaraichte, sgrùdadh lìn.

Cuir air bhog liosta-sgrùdaidh

+

Comharraich an SDK agad aig Shannon

Suidhich baseURL gu na puingean crìochnachaidh OpenAI no Anthropic gu h-àrd.

Suidhich
+

Ceangail an iuchair API agad

Cleachd comharran neach-giùlain airson fiosan OpenAI no dreach X-API-Key + antropic.

Tèarainteachd
+

Dèan comas air innealan & toraidhean structaraichte

A ’toirt taic do dh’ innealan / gnìomhan OpenAI, JSON sgeama, agus web_search togte.

Comasan
+

Rian cleachdadh

Thoir sùil air tòcan agus lorg caitheamh air an duilleag seo nuair a chlàraicheas tu a-steach don chunntas agad.

Analytics

Comasan

OpenAI + Antropic

Ath-chuir a-steach airson OpenAI agus APIan Anthropic le taic dhùthchasach airson innealan, toraidhean structaraichte, agus sgrùdadh lìn togte.

Ath-shuidheachadh Drop-in

Co-fhreagarrach

Ag obair le OpenAI agus SDKn Anthropic. Dìreach atharraich an URL bunaiteach.

Call gnìomh

Innealan

Mìnich innealan, leig le Shannon an gairm. A’ toirt taic do mhodhan fèin-ghluasadach, èignichte agus gun dad.

Rannsachadh Lìn air a thoirt a-steach

Rannsaich

Rannsachadh lìn fìor-ùine le luaidh thùsail. Ri fhaighinn gu fèin-ghluasadach.

Toraidhean structarail

JSON

Modh JSON agus JSON Co-èigneachadh sgeama airson às-tharraing dàta earbsach.

Innealan ioma-thionndaidh

àidseant

Lùban gnìomh gnìomh fèin-ghluasadach. Suas ri 10 tursan gach iarrtas.

Sruthadh

Fast

Tachartasan air an cur gu frithealaiche airson sruthadh comharran fìor-ùine.

Tòiseachadh Luath

5 mionaidean

Tòisich ann an trì ceumannan. Tha Shannon mar sgàthan air teachdaichean OpenAI agus Anthropic.

Suidhich an URL bunaiteach agad

Cleachd am puing crìochnachaidh a tha co-chosmhail ri OpenAI.

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

Cuir ris an iuchair API agad

Cleachd ùghdar Neach-giùlain ann am bann-cinn an Ùghdarrachaidh.

Cuir a’ chiad teachdaireachd agad

Tagh cànan agus atharraich san iuchair agad.

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

Fòrmat freagairt

Freagairt Soirbheachais

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

Raon-cluiche API

Ùr

Dèan deuchainn air an Shannon API gu dìreach sa bhrobhsair agad. Tog an t-iarrtas agad, ruith e, agus faic am freagairt ann an àm fìor.

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.

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

Feuch Raon-cluiche V2 Faigh an iuchair API agad

Dearbhadh

Feumaidh a h-uile iarrtas API dearbhadh a’ cleachdadh an iuchair Shannon API agad.

Cruth OpenAI (air a mholadh)

HTTP

Authorization: Bearer YOUR_API_KEY

Cruth anthropic

HTTP

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

Modailean

Tha Shannon a’ tabhann grunn mhodalan air an ùrachadh airson diofar chùisean cleachdaidh.

shannon-1.6-lite Shannon 1.6 Lite

Freagairtean luath, èifeachdach airson gnìomhan làitheil

Co-theacs 128K

As Fheàrr airson Còmhradh, Q&A, Gineadh Susbaint

shannon-1.6-pro Shannon 1.6 Pro

Reusanachadh adhartach airson duilgheadasan iom-fhillte

Co-theacs 128K

As Fheàrr airson Mion-sgrùdadh, Rannsachadh, Gnìomhan Iom-fhillte

shannon-2-lite Shannon 2 Lite

Co-theacs 128K

As Fheàrr airson

shannon-2-pro Shannon 2 Pro

Co-theacs 128K

As Fheàrr airson

shannon-coder-1 Shannon Coder

Optimated airson Claude Code CLI le cuota stèidhichte air gairm

Co-theacs 128K

As Fheàrr airson Gineadh còd, cleachdadh innealan, amalachadh CLI

Cuota stèidhichte air call

Call gnìomh

Mìnich innealan a dh'fhaodas Shannon a ghairm gus gnìomhan a dhèanamh no fiosrachadh fhaighinn air ais.

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

Roghainnean Inneal a 'Chlàir

"auto" Bidh modail a’ co-dhùnadh am bu chòir gnìomh a ghairm (bunaiteach)

"none" Cuir à comas gnìomh ag iarraidh an iarrtas seo

{"type": "function", "function": {"name": "..."}} Cuir an gnìomh gairm gnìomh sònraichte

Freagairt Call gnìomh

Nuair a bhios modail a 'gairm gnìomh

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

Toraidhean structarail

Thoir air Shannon freagairt le JSON dligheach a fhreagras ris an sgeama agad.

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

Roghainnean cruth freagairt

{"type": "json_object"} Feachd toradh dligheach JSON (gun sgeama sònraichte)

{"type": "json_schema", "json_schema": {...}} Toradh feachd a rèir an dearbh sgeama agad

Sruthadh

Dèan comas air sruthadh tòcan fìor-ùine le Tachartasan air an cur an fhrithealaiche airson UI freagairteach.

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

Gliocas: Bidh freagairtean sruthadh a’ tighinn mar Tachartasan air an cur an fhrithealaiche. Anns gach pìos tha delta le susbaint pàirt.

Rannsachadh Lìn air a thoirt a-steach

Tha Shannon a’ toirt a-steach gnìomh web_search togte a tha ri fhaighinn gu fèin-ghluasadach.

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

Gliocas Pro: Tha toraidhean rannsachaidh lìn a’ toirt a-steach luaidh. Bheir Shannon luaidh gu fèin-ghluasadach air stòran.

Cruth anthropic

Bidh Shannon cuideachd a’ toirt taic do chruth API Teachdaireachdan Anthropic.

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

Ceann-cinn a dhìth: Feumaidh cruth anthropic dreach antropic: 2023-06-01.

SDKs

Co-fhreagarrach

Cleachd OpenAI no SDK Anthropic sam bith - dìreach atharraich an URL bunaiteach.

SDKan co-chosmhail ri OpenAI

SDK Python

Oifigeil OpenAI Python SDK - ag obair còmhla ri Shannon

pip install openai

Faic Docs ->

SDK JavaScript / TypeScript

Oifigeil OpenAI Node.js SDK - ag obair còmhla ri Shannon

npm install openai

Faic Docs ->

SDK Go

Neach-dèiligidh Community Go airson APIan a tha co-chosmhail ri OpenAI

go get github.com/sashabaranov/go-openai

Faic Docs ->

SDK Ruby

Neach-dèiligidh Coimhearsnachd Ruby airson APIan a tha co-chosmhail ri OpenAI

gem install ruby-openai

Faic Docs ->

SDK PHP

Neach-dèiligidh PHP coimhearsnachd airson APIan a tha co-chosmhail ri OpenAI

composer require openai-php/client

Faic Docs ->

SDK Rust

Neach-dèiligidh Async Rust airson APIan a tha co-chosmhail ri OpenAI

cargo add async-openai

Faic Docs ->

SDKan co-fhreagarrach antropic

SDK Python (Anthropic)

Oifigeil Anthropic Python SDK - ag obair còmhla ri Shannon

pip install anthropic

Faic Docs ->

SDK TypeScript (Anthropic)

Oifigeil Anthropic TypeScript SDK - ag obair còmhla ri Shannon

npm install @anthropic-ai/sdk

Faic Docs ->

Làimhseachadh mearachd

Bidh Shannon a’ cleachdadh còdan inbhe HTTP àbhaisteach agus a’ tilleadh teachdaireachdan mearachd mionaideach.

400 Droch iarrtas Cruth iarrtas neo crìochan neo-dhligheach

401 Gun chead Iuchair API mì-dhligheach no a dhìth

402 Cuota air a dhol thairis air Chaidh cuota tòcan no lorg thairis air

429 Ìre Earranta Cus iarrtasan, slaodach sìos

500 Mearachd an Fhrithealaiche Mearachd a-staigh, feuch a-rithist nas fhaide air adhart

Fòrmat freagairt mearachd

Freagairt Mearachd

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

Clàr-atharrachaidh

LOG

Ùrachaidhean is leasachaidhean o chionn ghoirid air Shannon API.

v2.1.0

2025-01-03

Ùr Modail shannon-coder-1 air a chur ris airson amalachadh Claude Code CLI
Ùr Siostam cuota stèidhichte air gairm airson modal Coder
Leasaichte Gnìomh nas fheàrr a 'gairm earbsachd

v2.0.0

2024-12-15

Ùr Co-fhreagarrachd API Teachdaireachdan Anthropic air a chur ris
Ùr Cur an gnìomh inneal ioma-thionndaidh (suas ri 10 iterations)
Ùr JSON Taic cruth freagairt sgeama
Leasaichte Rannsachadh lìn nas fheàrr le luaidh nas fheàrr

v1.5.0

2024-11-20

Ùr Modail shannon-deep-dapo air a chur ris airson reusanachadh iom-fhillte
Ùr Gnìomh web_search togte
Leasaichte Lùghdachadh latency airson freagairtean sruthadh

v1.0.0

2024-10-01

Ùr Tionndadh API tùsail
Ùr Crìochnachaidhean còmhraidh a tha co-chosmhail ri OpenAI
Ùr Taic gairm gnìomh
Ùr A’ sruthadh tro thachartasan air an cur air frithealaiche

An iuchair API agad

Ruigsinneachd

Cleachd comharran neach-giùlain airson fiosan OpenAI no dreach X-API-Key + antropic.

YOUR_API_KEY

Faigh an iuchair API agad

Cùm an iuchair API agad dìomhair. Bidh ath-nuadhachadh a’ cruthachadh iuchair ùr agus a’ dèanamh an t-seann fhear neo-dhligheach.

Do Chleachdadh

Thoir sùil air tòcan agus lorg caitheamh air an duilleag seo nuair a chlàraicheas tu a-steach don chunntas agad.

-- Gairmean API

-- Comharran air an cleachdadh

Shannon API

Ro-shealladh

Comasan

Ath-shuidheachadh Drop-in

Call gnìomh

Rannsachadh Lìn air a thoirt a-steach

Toraidhean structarail

Innealan ioma-thionndaidh

Sruthadh

Tòiseachadh Luath

Suidhich an URL bunaiteach agad

Cuir ris an iuchair API agad

Cuir a’ chiad teachdaireachd agad

Fòrmat freagairt

Raon-cluiche API

Chat, Responses, Messages

Stream live output

Reuse your key

Dearbhadh

Cruth OpenAI (air a mholadh)

Cruth anthropic

Modailean

Call gnìomh

Roghainnean Inneal a 'Chlàir

Freagairt Call gnìomh

Toraidhean structarail

Roghainnean cruth freagairt

Sruthadh

Rannsachadh Lìn air a thoirt a-steach

Cruth anthropic

SDKs

SDKan co-chosmhail ri OpenAI

SDKan co-fhreagarrach antropic

Làimhseachadh mearachd

Fòrmat freagairt mearachd

Clàr-atharrachaidh

An iuchair API agad

Do Chleachdadh

Còd Shannon (shannon-coder-1)

Deiseil airson togail?

Shannon AI API Documentation

Ro-shealladh

Comasan

Ath-shuidheachadh Drop-in

Call gnìomh

Rannsachadh Lìn air a thoirt a-steach

Toraidhean structarail

Innealan ioma-thionndaidh

Sruthadh

Tòiseachadh Luath

Suidhich an URL bunaiteach agad

Cuir ris an iuchair API agad

Cuir a’ chiad teachdaireachd agad

Fòrmat freagairt

Raon-cluiche API

Chat, Responses, Messages

Stream live output

Reuse your key

Dearbhadh

Cruth OpenAI (air a mholadh)

Cruth anthropic

Modailean

Call gnìomh

Roghainnean Inneal a 'Chlàir

Freagairt Call gnìomh

Toraidhean structarail

Roghainnean cruth freagairt

Sruthadh

Rannsachadh Lìn air a thoirt a-steach

Cruth anthropic

SDKs

SDKan co-chosmhail ri OpenAI

SDKan co-fhreagarrach antropic

Làimhseachadh mearachd

Fòrmat freagairt mearachd

Clàr-atharrachaidh

An iuchair API agad

Do Chleachdadh

Còd Shannon (shannon-coder-1)

Deiseil airson togail?