Logotipo de SHANNON A.I.
SHANNONA.I.
ChatPreciosAPIInvestigaciónEmpresaPentest AIStartup Boost

Cargando interfaz

Comprobando estado...
Documentación de API

API de Shannon

API de IA compatible con OpenAI y Anthropic con llamadas a funciones, búsqueda web y salidas estructuradas.

Obtener tu clave APIProbar PlaygroundV2
Documentación
  • Resumen
  • Capacidades
  • Inicio rápido
  • Playground de APINuevo
  • Autenticación
  • Modelos
  • Llamadas a funciones
  • Salidas estructuradas
  • Streaming
  • Búsqueda web integrada
  • Formato Anthropic
  • SDKs
  • Manejo de errores
  • Registro de cambios

Shannon AI API Documentation

Resumen

Docs públicas

Todo lo que necesitas para lanzar con la API compatible con OpenAI y Anthropic de Shannon.

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

Usa la API Chat Completions con function calling y streaming.

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

Formato Claude Messages con tools y cabecera anthropic-version.

EncabezadosAutenticación
Autorización: Bearer <tu-clave>

O usa X-API-Key con anthropic-version para llamadas estilo Claude.

AccessStatus
Public docs - Key required to call

Streaming, function calling, salidas estructuradas y búsqueda web.

Checklist de lanzamiento
  • ✓
    Apunta tu SDK a Shannon
    Configura baseURL al endpoint de OpenAI o Anthropic de arriba.
    Setup
  • ✓
    Añade tu API key
    Usa Bearer para llamadas OpenAI o X-API-Key + anthropic-version.
    Security
  • ✓
    Activa tools y salidas estructuradas
    Soporta tools/functions de OpenAI, JSON schema y web_search integrado.
    Capacidades
  • ✓
    Supervisa el uso
    Consulta consumo de tokens y búsquedas en esta página al iniciar sesión.
    Analytics

Capacidades

OpenAI + Anthropic

Reemplazo directo de APIs OpenAI y Anthropic con soporte nativo de tools, salidas estructuradas y búsqueda web integrada.

Reemplazo directo

Compatible

Funciona con los SDK de OpenAI y Anthropic. Solo cambia la URL base.

Llamadas de funciones

Herramientas

Define herramientas y deja que Shannon las llame. Soporta modos auto, forzado y ninguno.

Búsqueda web integrada

Búsqueda

Búsqueda web en tiempo real con citas de fuentes. Disponible automáticamente.

Salidas estructuradas

JSON

Modo JSON y cumplimiento de JSON Schema para extracción fiable de datos.

Herramientas multi‑turno

Agéntico

Bucles automáticos de ejecución de funciones. Hasta 10 iteraciones por solicitud.

Streaming

Rápido

Eventos enviados por el servidor para streaming de tokens en tiempo real.

Inicio rápido

5 minutos

Empieza en tres pasos. Shannon refleja los clientes de OpenAI y Anthropic.

1

Configura tu URL base

Usa el endpoint compatible con OpenAI.

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

Añade tu clave API

Usa autenticación Bearer en el encabezado Authorization.

3

Envía tu primer mensaje

Elige un idioma y reemplaza con tu clave.

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

Respuesta exitosa
{
  "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 de API

Nuevo

Prueba la API de Shannon directamente en tu navegador. Construye tu solicitud, ejecútala y ve la respuesta en tiempo real.

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
}

Autenticación

Todas las solicitudes API requieren autenticación con tu API key de Shannon.

OpenAI Format (Recommended)

HTTP
Authorization: Bearer YOUR_API_KEY

Formato Anthropic

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

Modelos

Shannon ofrece varios modelos optimizados para distintos casos de uso.

shannon-balanced-grpoBalanced

Fast, efficient responses for everyday tasks

Contexto128K
Ideal paraChat, Q&A, Content Generation
shannon-deep-dapoDeep

Advanced reasoning for complex problems

Contexto128K
Ideal paraAnalysis, Research, Complex Tasks
shannon-coder-1Coder

Optimized for Claude Code CLI with call-based quota

Contexto128K
Ideal paraCode Generation, Tool Use, CLI Integration
Call-based quota

Llamadas a funciones

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

Opciones de selección de herramienta

"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

Respuesta de llamada de función

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

Salidas estructuradas

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

Opciones de formato de respuesta

{"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)
Consejo: Streaming responses arrive as Server-Sent Events. Each chunk contains a delta with partial content.

Búsqueda web integrada

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
Consejo pro: Los resultados de búsqueda web incluyen citas. Shannon citará fuentes automáticamente.

Formato Anthropic

Shannon también soporta el formato Messages API de 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)
Encabezado obligatorio: Anthropic format requires anthropic-version: 2023-06-01.

SDKs

Compatible

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

Manejo de errores

Shannon usa códigos de estado HTTP estándar y devuelve mensajes de error detallados.

400Solicitud incorrectaFormato o parámetros de solicitud inválidos
401No autorizadoClave API inválida o faltante
402Cuota excedidaCuota de tokens o de búsqueda excedida
429Límite de tasaDemasiadas solicitudes, reduce la velocidad
500Error del servidorError interno, reintenta más tarde

Formato de respuesta de error

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

Registro de cambios

Recent updates and improvements to the Shannon API.

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

¿Listo para construir?

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

Obtener tu clave APIVer precios