Logo SHANNON A.I.
SHANNONA.I.
ChatPrezziAPIRicercaAziendaPentest AIStartup Boost

Caricamento interfaccia

Verifica dello stato...
Documentazione API

API Shannon

API di IA compatibile con OpenAI e Anthropic con chiamate di funzione, ricerca web e output strutturati.

Ottieni chiave APIProva PlaygroundV2
Documentazione
  • Panoramica
  • Funzionalità
  • Avvio rapido
  • Playground APINuovo
  • Autenticazione
  • Modelli
  • Chiamata di funzioni
  • Output strutturati
  • Streaming
  • Ricerca web integrata
  • Formato Anthropic
  • SDK
  • Gestione errori
  • Registro modifiche

Shannon AI API Documentation

Panoramica

Docs pubblici

Tutto ciò che serve per rilasciare con l'API compatibile OpenAI e Anthropic di Shannon.

URL baseCompatibile con OpenAI
https://us-central1-shannonai.cloudfunctions.net/v1/chat/completions

Usa la Chat Completions API con function calling e streaming.

URL baseCompatibile con Anthropic
https://us-central1-shannonai.cloudfunctions.net/v1/messages

Formato Claude Messages con tools e header anthropic-version.

IntestazioniAutenticazione
Autorizzazione: Bearer <la-tua-chiave>

Oppure usa X-API-Key con anthropic-version per chiamate in stile Claude.

AccessStatus
Public docs - Key required to call

Streaming, function calling, output strutturati e ricerca web.

Checklist di lancio
  • ✓
    Punta il tuo SDK a Shannon
    Imposta baseURL all'endpoint OpenAI o Anthropic qui sopra.
    Setup
  • ✓
    Aggiungi la tua chiave API
    Usa Bearer per OpenAI o X-API-Key + anthropic-version.
    Security
  • ✓
    Abilita tools e output strutturati
    Supporta tools/functions OpenAI, JSON schema e web_search integrato.
    Funzionalità
  • ✓
    Monitora l'utilizzo
    Visualizza consumo token e ricerche in questa pagina dopo il login.
    Analytics

Funzionalità

OpenAI + Anthropic

Sostituzione diretta delle API OpenAI e Anthropic con supporto nativo per tools, output strutturati e ricerca web.

Sostituzione diretta

Compatibile

Funziona con gli SDK OpenAI e Anthropic. Basta cambiare la base URL.

Chiamate di funzione

Strumenti

Definisci strumenti e lascia che Shannon li chiami. Supporta modalità auto, forzata e nessuna.

Ricerca web integrata

Ricerca

Ricerca web in tempo reale con citazioni delle fonti. Disponibile automaticamente.

Output strutturati

JSON

Modalità JSON e applicazione di JSON Schema per estrazione dati affidabile.

Strumenti multi‑turno

Agentico

Loop automatici di esecuzione funzioni. Fino a 10 iterazioni per richiesta.

Streaming

Rapido

Server‑Sent Events per lo streaming di token in tempo reale.

Avvio rapido

5 minuti

Inizia in tre passaggi. Shannon rispecchia i client OpenAI e Anthropic.

1

Imposta la base URL

Usa l’endpoint compatibile con OpenAI.

https://us-central1-shannonai.cloudfunctions.net/v1/chat/completions
2

Aggiungi la tua chiave API

Usa l’autenticazione Bearer nell’header Authorization.

3

Invia il tuo primo messaggio

Scegli una lingua e sostituisci con la tua chiave.

Python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://us-central1-shannonai.cloudfunctions.net/v1"
)
response = client.chat.completions.create(
model="shannon-balanced-grpo",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello, Shannon!"}
],
max_tokens=1024
)
print(response.choices[0].message.content)

Formato di risposta

Risposta riuscita
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "shannon-balanced-grpo",
  "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 API

Nuovo

Prova l’API Shannon direttamente nel browser. Costruisci la richiesta, eseguila e vedi la risposta in tempo reale.

Claude-style API studio

One polished workbench for every public endpoint.

Switch between Chat Completions, Responses, and Messages without changing pages. The request body, auth header, stream parser, and SDK snippets all follow the selected protocol.

Endpoints3
ThemeCrail / Pampas
Latest response IDNot captured yet
Composer

Chat Completions

Live response

/v1/chat/completions

Chat Completions Idle 0 SSE events No reasoning block
response_idWaiting for a response...
Ready to test.

Pick an endpoint, shape the payload, and run the request to inspect the live output.

0
SDK snippets

Keep the request, headers, and client syntax aligned with the selected endpoint.

JSON
{
"model": "shannon-balanced-grpo",
"messages": [
{
"role": "system",
"content": "You are Shannon. Answer crisply, commercially, and with strong structure."
},
{
"role": "user",
"content": "Outline a clean launch plan for a new AI API aimed at startup founders."
}
],
"max_tokens": 1024,
"temperature": 0.7,
"stream": true
}

Autenticazione

Tutte le richieste API richiedono autenticazione con la tua chiave API Shannon.

OpenAI Format (Recommended)

HTTP
Authorization: Bearer YOUR_API_KEY

Formato Anthropic

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

Modelli

Shannon offre più modelli ottimizzati per diversi casi d'uso.

shannon-balanced-grpoBalanced

Fast, efficient responses for everyday tasks

Contesto128K
Ideale perChat, Q&A, Content Generation
shannon-deep-dapoDeep

Advanced reasoning for complex problems

Contesto128K
Ideale perAnalysis, Research, Complex Tasks
shannon-coder-1Coder

Optimized for Claude Code CLI with call-based quota

Contesto128K
Ideale perCode Generation, Tool Use, CLI Integration
Call-based quota

Chiamata di funzioni

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://us-central1-shannonai.cloudfunctions.net/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-balanced-grpo",
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}")

Opzioni di scelta dello strumento

"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

Risposta alla chiamata di funzione

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

Output strutturati

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://us-central1-shannonai.cloudfunctions.net/v1"
)
# Force JSON output with schema
response = client.chat.completions.create(
model="shannon-balanced-grpo",
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"}

Opzioni formato risposta

{"type": "json_object"}Force valid JSON output (no specific schema)
{"type": "json_schema", "json_schema": {...}}Force output matching your exact schema

Streaming

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://us-central1-shannonai.cloudfunctions.net/v1"
)
# Enable streaming for real-time responses
stream = client.chat.completions.create(
model="shannon-balanced-grpo",
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)
Suggerimento: Streaming responses arrive as Server-Sent Events. Each chunk contains a delta with partial content.

Ricerca web integrata

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://us-central1-shannonai.cloudfunctions.net/v1"
)
# Web search is automatically available!
# Shannon will use it when needed for current information
response = client.chat.completions.create(
model="shannon-balanced-grpo",
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
Suggerimento pro: I risultati web includono citazioni. Shannon citerà automaticamente le fonti.

Formato Anthropic

Shannon supporta anche il formato Messages API di Anthropic.

https://us-central1-shannonai.cloudfunctions.net/v1/messages
Python
import anthropic
client = anthropic.Anthropic(
api_key="YOUR_API_KEY",
base_url="https://us-central1-shannonai.cloudfunctions.net/messages"
)
response = client.messages.create(
model="shannon-balanced-grpo",
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)
Header richiesto: Anthropic format requires anthropic-version: 2023-06-01.

SDK

Compatibile

Use any OpenAI or Anthropic SDK - just change the base URL.

OpenAI-Compatible SDKs

Python

Official OpenAI Python SDK - works with Shannon

pip install openai
View Docs
JavaScript / TypeScript

Official OpenAI Node.js SDK - works with Shannon

npm install openai
View Docs
Go

Community Go client for OpenAI-compatible APIs

go get github.com/sashabaranov/go-openai
View Docs
Ruby

Community Ruby client for OpenAI-compatible APIs

gem install ruby-openai
View Docs
PHP

Community PHP client for OpenAI-compatible APIs

composer require openai-php/client
View Docs
Rust

Async Rust client for OpenAI-compatible APIs

cargo add async-openai
View Docs

Anthropic-Compatible SDKs

Python (Anthropic)

Official Anthropic Python SDK - works with Shannon

pip install anthropic
View Docs
TypeScript (Anthropic)

Official Anthropic TypeScript SDK - works with Shannon

npm install @anthropic-ai/sdk
View Docs

Gestione errori

Shannon usa codici di stato HTTP standard e restituisce messaggi di errore dettagliati.

400Richiesta non validaFormato o parametri della richiesta non validi
401Non autorizzatoChiave API mancante o non valida
402Quota superataQuota token o ricerca superata
429Limite di rateTroppe richieste, rallenta
500Errore del serverErrore interno, riprova più tardi

Formato risposta errore

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

Registro modifiche

Recent updates and improvements to the Shannon API.

v2.1.0
2025-01-03
  • NuovoAdded shannon-coder-1 model for Claude Code CLI integration
  • NuovoCall-based quota system for Coder model
  • ImprovedImproved function calling reliability
v2.0.0
2024-12-15
  • NuovoAdded Anthropic Messages API compatibility
  • NuovoMulti-turn tool execution (up to 10 iterations)
  • NuovoJSON Schema response format support
  • ImprovedEnhanced web search with better citations
v1.5.0
2024-11-20
  • NuovoAdded shannon-deep-dapo model for complex reasoning
  • NuovoBuilt-in web_search function
  • ImprovedReduced latency for streaming responses
v1.0.0
2024-10-01
  • NuovoInitial API release
  • NuovoOpenAI-compatible chat completions endpoint
  • NuovoFunction calling support
  • NuovoStreaming via Server-Sent Events

Pronto a costruire?

Get your API key and start building with Shannon AI today.

Ottieni chiave APIVedi prezzi