Registro de cambios

Una solicitud con web_search: true nombra sus fuentes: sources en /v1/chat/completions y /v1/messages lista los resultados que recibió el modelo, y en /v1/chat/completions annotations marca dónde cita la respuesta cada uno. Búsqueda web integrada

web_search: true en /v1/chat/completions y /v1/messages ejecuta una búsqueda web antes de que el modelo responda y le entrega los resultados como fuentes numeradas. Una solicitud que encontró resultados usa una búsqueda de tu cuota diaria. Si no queda ninguna, la solicitud se responde sin búsqueda. Búsqueda web integrada

Un stream que se corta en el lado del servidor se factura por el uso informado hasta ese punto. El resto de la reserva vuelve a tu saldo.

shannon-coder-1 responde en /v1/responses igual que en los otros dos endpoints. Herramientas CLI de programación

Una clave API rotada deja de funcionar de inmediato.

POST /v1/tokenize y POST /v1/messages/count_tokens: conteos de tokens gratuitos para los modelos de pesos abiertos alojados. Conteo de tokens

Prompt caching en los modelos de pesos abiertos alojados. La entrada en caché se factura al 25% del precio de entrada y se informa en usage en los tres endpoints: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens y cache_read_input_tokens. GET /v1/models informa pricing.cached_input_per_million_usd y capabilities.prompt_caching para estos modelos. Caché de prompts

Modelos de pesos abiertos alojados: un tool_choice forzado (required o una función con nombre) produce una llamada a herramienta. Llamadas a funciones

Los modelos de pesos abiertos alojados aceptan un mensaje system que no es el primer mensaje de la conversación.

La API es accesible como servicio onion de Tor y en una dirección I2P. Las respuestas de api.shannon-ai.com llevan las dos direcciones en los headers Onion-Location y X-I2P-Location. Endpoints cifrados, Tor e I2P

Nuevos modelos shannon-3.1 y shannon-3.1-pro, listados por GET /v1/models. Modelos y precios

Una solicitud con streaming cuyo cliente se desconecta se ejecuta hasta el final y se cuenta. Antes, la respuesta se detenía al desconectarse.

Las solicitudes a /v1/responses aparecen en el registro de uso.

Los modelos de pesos abiertos alojados aplican los campos de muestreo: temperature, top_p, seed, stop y max_tokens en /v1/chat/completions; temperature, top_p y stop_sequences en /v1/messages; temperature, top_p y max_output_tokens en /v1/responses. Chat Completions

El registro de uso muestra un costo en USD por cada llamada y como total.

Un valor de model que no es un id publicado se responde con 400, el tipo invalid_request_error y el mensaje unknown model: <id> en los tres endpoints. Antes, esa solicitud la respondía shannon-1.6-lite. Modelos y precios

/v1 acepta solo una clave API. Allí no se lee una cookie de inicio de sesión del sitio web. Autenticación

Protección contra flood: 120 solicitudes por minuto por cuenta en los tres endpoints de generación. Límites y saldo

Cuando el modelo no puede responder, el error lleva el mensaje fijo The model backend failed to answer. Please retry. Una comprobación de saldo que no se puede realizar se responde con 503 y el tipo api_error. Manejo de errores

Una solicitud sin streaming que falla devuelve su reserva a tu saldo.

GET /v1/models informa capabilities.reasoning_effort para cada modelo. Esfuerzo de razonamiento

Modelos de pesos abiertos alojados: una solicitud sin streaming que no recibe respuesta termina con 504 y el tipo api_error. Un resultado vacío es 502. Manejo de errores

Los modelos de pesos abiertos alojados aceptan la entrada que acepta el modelo con ese nombre. Una imagen enviada a un id de solo texto se responde con 400 y <id> does not accept image input. response_format en un id sin salida estructurada se responde con 400. GET /v1/models informa capabilities.vision, response_format y json_schema para cada id. Imágenes y archivos

Las respuestas sin streaming llevan el texto de razonamiento: reasoning_content en el mensaje de /v1/chat/completions, y un bloque thinking antes del texto en /v1/messages. Esfuerzo de razonamiento

Los modelos de pesos abiertos alojados tienen precios nuevos, desde $0.50 por 1M de tokens de entrada y $2.00 por 1M de tokens de salida. Modelos y precios

Los modelos de pesos abiertos alojados tienen un id por modelo, doce ids en total. Modelos y precios

Salida estructurada en shannon-3, shannon-3-pro, shannon-3.1 y shannon-3.1-pro. GET /v1/models informa capabilities.json_schema: true para ellos. Salidas estructuradas

/v1/responses lee text.format (json_object o json_schema) para la salida estructurada. API Responses

/v1/responses devuelve el razonamiento de los modelos Shannon: un elemento de salida reasoning antes del elemento message, y los eventos de stream response.reasoning_summary_text.delta y response.reasoning_summary_text.done. API Responses

El campo model de una respuesta es el id publicado en todos los endpoints. Un objeto Responses lleva model y created_at.

GET /v1/models informa de la ventana de contexto de cada modelo. Modelos y precios

Los modelos de pesos abiertos alojados responden en /v1/messages y /v1/responses además de en /v1/chat/completions, con tu system prompt y llamadas a herramientas. /v1/messages acepta thinking, y reasoning_effort es un campo de la solicitud. Modelos y precios

Los cuerpos de error en /v1 siguen las formas de los SDK: un objeto error con type y message en los endpoints con formato OpenAI, y el mismo objeto dentro de {"type": "error"} en /v1/messages. Manejo de errores

Keep-alive en los streams abiertos cada 15 segundos: una línea de comentario : ping en /v1/chat/completions, un event: ping en /v1/messages. Streaming

Los ids de llamada a herramienta empiezan por call_ en /v1/chat/completions y /v1/responses, y por toolu_ en /v1/messages. Llamadas a funciones

/v1/responses: stream es false por defecto. API Responses

max_completion_tokens se acepta como otro nombre de max_tokens en /v1/chat/completions. Chat Completions

El evento response.completed de un stream de Responses lleva el array output. API Responses

Las entradas de GET /v1/models llevan display_name, context_window, max_output_tokens, pricing, capabilities y endpoints. Modelos y precios

Cada respuesta lleva x-request-id, y un valor que envíes se devuelve. Los cuerpos de solicitud pueden tener hasta 32 MiB.

Una clave se puede revocar sin que se emita una nueva. El registro de uso está paginado.

Imágenes y documentos en las solicitudes: partes image_url en /v1/chat/completions, bloques image, document y file en /v1/messages, partes input_image en /v1/responses. Imágenes y archivos

Nuevo modelo shannon-3-pro. Modelos y precios

Nuevo modelo shannon-3. Modelos y precios

Los streams en /v1/chat/completions llevan el razonamiento como delta.reasoning_content. Esfuerzo de razonamiento

max_tokens se mantiene entre 1 y 65,536. Un valor fuera de ese rango se lleva al extremo más cercano, no se rechaza. Chat Completions

shannon-coder-1 se cuenta en llamadas por plan en /v1/chat/completions y /v1/messages. Cuando se agotan las llamadas de una ventana, la respuesta es 429 con el mensaje Shannon Coder call quota reached. Herramientas CLI de programación

Una conversación mayor que la ventana de contexto se responde con 400, el tipo invalid_request_error y el código context_length_exceeded. Un error dentro de un stream llega como un evento de error, no como texto en la respuesta. Herramientas CLI de programación

Los endpoints /v1: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses y GET /v1/models. Son los endpoints a los que llaman los SDK de OpenAI y Anthropic, Claude Code y Codex CLI. Resumen

Llamadas a herramientas con tools en /v1/chat/completions y /v1/messages, salida estructurada con response_format, y system como cadena o como bloques de texto en /v1/messages. Llamadas a funciones

Ids de modelo shannon-1.6-pro, shannon-2-lite, shannon-2-pro y shannon-coder-1, junto a shannon-1.6-lite. Modelos y precios

Primera versión de la API: chat en el formato de OpenAI y en el formato de Anthropic, y un endpoint Responses, cada uno llamado con una clave API que empieza por sk-. Autenticación