Ath-shuidheachadh Drop-in
Co-fhreagarrachAg obair le OpenAI agus SDKn Anthropic. Dìreach atharraich an URL bunaiteach.
Sgrìobhainnean API
Shannon API
API AI co-chosmhail OpenAI & Anthropic le gairm gnìomh, sgrùdadh lìn, agus toraidhean structaraichte.
Shannon AI API Documentation
Ro-shealladh
Sgrìobhainnean poblachA h-uile dad a dh’ fheumas tu a chuir air falbh le Shannon's OpenAI agus API co-fhreagarrach Anthropic.
https://api.shannon-ai.com/v1/chat/completions Cleachd an Chat Compmpletions API le gairm gnìomh agus sruthadh.
https://api.shannon-ai.com/v1/messages Cruth Claude Messages le innealan agus bann-cinn dreach anthropic.
Ùghdarrachadh: Neach-giùlain <your-key> No X-API-Key le dreach anthropic airson gairmean ann an stoidhle Claude.
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
- + SuidhichComharraich an SDK agad aig ShannonSuidhich baseURL gu na puingean crìochnachaidh OpenAI no Anthropic gu h-àrd.
- + TèarainteachdCeangail an iuchair API agadCleachd comharran neach-giùlain airson fiosan OpenAI no dreach X-API-Key + antropic.
- + ComasanDèan comas air innealan & toraidhean structaraichteA ’toirt taic do dh’ innealan / gnìomhan OpenAI, JSON sgeama, agus web_search togte.
- + AnalyticsRian cleachdadhThoir sùil air tòcan agus lorg caitheamh air an duilleag seo nuair a chlàraicheas tu a-steach don chunntas agad.
Comasan
OpenAI + AntropicAth-chuir a-steach airson OpenAI agus APIan Anthropic le taic dhùthchasach airson innealan, toraidhean structaraichte, agus sgrùdadh lìn togte.
Call gnìomh
InnealanMì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
RannsaichRannsachadh lìn fìor-ùine le luaidh thùsail. Ri fhaighinn gu fèin-ghluasadach.
Toraidhean structarail
JSONModh JSON agus JSON Co-èigneachadh sgeama airson às-tharraing dàta earbsach.
Innealan ioma-thionndaidh
àidseantLùban gnìomh gnìomh fèin-ghluasadach. Suas ri 10 tursan gach iarrtas.
Sruthadh
FastTachartasan air an cur gu frithealaiche airson sruthadh comharran fìor-ùine.
Tòiseachadh Luath
5 mionaideanTòisich ann an trì ceumannan. Tha Shannon mar sgàthan air teachdaichean OpenAI agus Anthropic.
1
Suidhich an URL bunaiteach agad
Cleachd am puing crìochnachaidh a tha co-chosmhail ri OpenAI.
https://api.shannon-ai.com/v1/chat/completions 2
Cuir ris an iuchair API agad
Cleachd ùghdar Neach-giùlain ann am bann-cinn an Ùghdarrachaidh.
3
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); Go
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
ÙrDè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.
1
Chat, Responses, Messages
Switch across OpenAI Chat Completions, Responses, and Anthropic Messages without leaving the playground.
2
Stream live output
Run real requests, inspect raw JSON, and view stream events from the same operator console.
3
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.
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_KEYCruth anthropic
HTTP
X-API-Key: YOUR_API_KEY
anthropic-version: 2023-06-01Modailean
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
shannon-1.6-pro Shannon 1.6 Pro Reusanachadh adhartach airson duilgheadasan iom-fhillte
shannon-2-lite Shannon 2 Lite
shannon-2-pro Shannon 2 Pro
shannon-coder-1 Shannon Coder Optimated airson Claude Code CLI le cuota stèidhichte air gairm
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
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
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.
CLI Coding Agents
NEWUse Shannon as the AI backend for popular CLI coding agents. Read files, edit code, run tests — all powered by Shannon's API.
CLI Claude Code
Anthropic's official CLI coding agent. Point it at Shannon to use as your AI backend for reading, editing, and running code directly in your terminal.
ANTHROPIC_BASE_URL=https://api.shannon-ai.com ANTHROPIC_API_KEY=sk-YOUR_KEY claude --bare CLI Codex CLI
OpenAI's open-source coding agent. Uses the Responses API for multi-turn tool use, file editing, and shell commands — all routed through Shannon.
OPENAI_BASE_URL=https://api.shannon-ai.com/v1 OPENAI_API_KEY=sk-YOUR_KEY codex Claude Code
Anthropic's official CLI coding agent. Set two environment variables and launch with --bare to skip Anthropic account login.
Bash
# Install Claude Code (requires Node.js 18+)
npm install -g @anthropic-ai/claude-code
# Connect to Shannon AI as backend
export ANTHROPIC_BASE_URL=https://api.shannon-ai.com
export ANTHROPIC_API_KEY=sk-YOUR_API_KEY
# Launch Claude Code in bare mode (no Anthropic account needed)
claude --bare
# Or run a one-shot command
claude --bare -p "Explain this codebase"
# Claude Code will use Shannon's Anthropic-compatible API
# for all AI operations: reading files, editing code,
# running tests, and multi-turn tool use. Shell Config
# Alternative: set env vars permanently in your shell profile
# ~/.bashrc or ~/.zshrc
export ANTHROPIC_BASE_URL=https://api.shannon-ai.com
export ANTHROPIC_API_KEY=sk-YOUR_API_KEY
# Then just run:
claude --bare
# Supported features through Shannon:
# - Multi-turn conversations with full context
# - File reading and editing (tool use)
# - Shell command execution
# - Streaming responses
# - All Claude Code slash commands (/compact, /clear, etc.)Codex CLI
OpenAI's open-source coding agent. Uses the Responses API for multi-turn tool use, file editing, and shell commands.
Bash
# Install Codex CLI
npm install -g @openai/codex
# Connect to Shannon AI as backend
export OPENAI_BASE_URL=https://api.shannon-ai.com/v1
export OPENAI_API_KEY=sk-YOUR_API_KEY
# Launch Codex
codex
# Or run a one-shot command
codex "fix the bug in main.py"
# Codex uses the Responses API (POST /v1/responses)
# Shannon handles tool calls including:
# - Reading and writing files
# - Running shell commands
# - Multi-turn function calling Shell Config
# Alternative: set env vars permanently
# ~/.bashrc or ~/.zshrc
export OPENAI_BASE_URL=https://api.shannon-ai.com/v1
export OPENAI_API_KEY=sk-YOUR_API_KEY
# Then just run:
codex
# Supported features through Shannon:
# - Responses API with full tool use
# - Function calling (file read/write, shell exec)
# - Streaming with real-time output
# - Multi-turn conversations
# - All Codex approval modes (suggest, auto-edit, full-auto) How It Works: Both tools send standard API requests (Anthropic Messages or OpenAI Responses) to Shannon. Shannon routes them through Gemini with full tool-use support. No Anthropic or OpenAI account needed — just your Shannon API key.
SDKs
Co-fhreagarrachCleachd 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 SDK JavaScript / TypeScript
Oifigeil OpenAI Node.js SDK - ag obair còmhla ri Shannon
npm install openai SDK Go
Neach-dèiligidh Community Go airson APIan a tha co-chosmhail ri OpenAI
go get github.com/sashabaranov/go-openai SDK Ruby
Neach-dèiligidh Coimhearsnachd Ruby airson APIan a tha co-chosmhail ri OpenAI
gem install ruby-openai SDK PHP
Neach-dèiligidh PHP coimhearsnachd airson APIan a tha co-chosmhail ri OpenAI
composer require openai-php/client SDK Rust
Neach-dèiligidh Async Rust airson APIan a tha co-chosmhail ri OpenAI
cargo add async-openai SDKan co-fhreagarrach antropic
SDK Python (Anthropic)
Oifigeil Anthropic Python SDK - ag obair còmhla ri Shannon
pip install anthropic SDK TypeScript (Anthropic)
Oifigeil Anthropic TypeScript SDK - ag obair còmhla ri Shannon
npm install @anthropic-ai/sdk 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.2.0
2026-03-28 - Ùr Claude Code support — use Shannon as your Anthropic backend for the official CLI coding agent
- Ùr Codex CLI support — full Responses API with multi-turn tool use for OpenAI's coding agent
- Leasaichte Anthropic streaming format fixes — proper content_block lifecycle, tool_use deltas, toolu_ prefixes
- Leasaichte Schema sanitization for Gemini — strips $schema, additionalProperties, $ref and other unsupported fields from tool schemas
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 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
Còd Shannon (shannon-coder-1)
Cuota stèidhichte air gairm airson Shannon Coder (shannon-coder-1). Ath-shuidheachadh gach 4 uairean.
0 Glaodhan air an cleachdadh
0 Glaodh air fhàgail
Deiseil airson togail?
Faigh an iuchair API agad agus tòisich a’ togail le Shannon AI an-diugh.
Rannsachadh mòr-chòrdte:
Feuch diofar fhaclan-luirg