更新日志

带 web_search: true 的请求会给出它的来源：/v1/chat/completions 和 /v1/messages 上的 sources 列出交给模型的结果，而在 /v1/chat/completions 上，annotations 标出答案在哪里引用了每一条。 内置网页搜索

/v1/chat/completions 和 /v1/messages 上的 web_search: true 会在模型回答前运行网页搜索，并把结果作为编号来源交给模型。找到结果的请求会消耗你每日额度中的一次搜索。若额度已用完，请求将在不搜索的情况下作答。 内置网页搜索

在服务端被切断的流，按截至该时刻报告的用量计费。预留额度的其余部分退回你的余额。

shannon-coder-1 在 /v1/responses 上的作答方式与另外两个端点相同。 CLI 编程工具

轮换后的 API 密钥会立即失效。

POST /v1/tokenize 和 POST /v1/messages/count_tokens：为托管开源权重模型提供免费的 token 计数。 Token 计数

托管开源权重模型支持 prompt 缓存。缓存的输入按输入价格的 25% 计费，并在三个端点的 usage 中报告：prompt_tokens_details.cached_tokens、input_tokens_details.cached_tokens 和 cache_read_input_tokens。GET /v1/models 为这些模型报告 pricing.cached_input_per_million_usd 和 capabilities.prompt_caching。 Prompt 缓存

托管开源权重模型：强制的 tool_choice（required 或指定函数）会产生工具调用。 函数调用

托管开源权重模型接受不是对话第一条消息的 system 消息。

API 可通过 Tor onion 服务和 I2P 地址访问。api.shannon-ai.com 的回复在 Onion-Location 和 X-I2P-Location 请求头中携带这两个地址。 加密、Tor 与 I2P 端点

新模型 shannon-3.1 和 shannon-3.1-pro，由 GET /v1/models 列出。 模型与定价

客户端断开连接的流式请求会运行到结束并被计入用量。此前，答案会在断开处停止。

对 /v1/responses 的请求会出现在用量日志中。

托管开源权重模型应用采样字段：/v1/chat/completions 上的 temperature、top_p、seed、stop 和 max_tokens；/v1/messages 上的 temperature、top_p 和 stop_sequences；/v1/responses 上的 temperature、top_p 和 max_output_tokens。 Chat Completions

用量日志按每次调用以及合计显示以美元计的费用。

不是已发布 id 的 model 值，在所有三个端点上都会得到 400、类型 invalid_request_error 和消息 unknown model: <id>。此前，这类请求由 shannon-1.6-lite 作答。 模型与定价

/v1 只接受 API 密钥。网站的登录 cookie 在那里不会被读取。 认证

限流保护：三个生成端点上每个账户每分钟 120 个请求。 限制与余额

当模型无法作答时，错误带有固定消息 The model backend failed to answer. Please retry.。无法完成的余额检查会得到 503，类型为 api_error。 错误处理

失败的非流式请求会把它的预留额度退回你的余额。

GET /v1/models 为每个模型报告 capabilities.reasoning_effort。 推理强度

托管开源权重模型：得不到答复的非流式请求以 504 和类型 api_error 结束。空结果为 502。 错误处理

托管开源权重模型接受所指定模型所接受的输入。向纯文本 id 发送图片会得到 400 和 <id> does not accept image input。对没有结构化输出的 id 使用 response_format 会得到 400。GET /v1/models 为每个 id 报告 capabilities.vision、response_format 和 json_schema。 图片与文件

非流式回复也带有推理文本：/v1/chat/completions 的消息上是 reasoning_content，/v1/messages 上是位于文本之前的 thinking 块。 推理强度

托管开源权重模型有了新价格，起价为每 1M 输入 tokens $0.50 和每 1M 输出 tokens $2.00。 模型与定价

托管开源权重模型每个模型有一个 id，共十二个 id。 模型与定价

shannon-3、shannon-3-pro、shannon-3.1 和 shannon-3.1-pro 支持结构化输出。GET /v1/models 对它们报告 capabilities.json_schema: true。 结构化输出

/v1/responses 读取 text.format（json_object 或 json_schema）以实现结构化输出。 Responses API

/v1/responses 返回 Shannon 模型的推理：在 message 项之前有一个 reasoning 输出项，以及流事件 response.reasoning_summary_text.delta 和 response.reasoning_summary_text.done。 Responses API

回复的 model 字段在每个端点上都是已发布的 id。Responses 对象带有 model 和 created_at。

GET /v1/models 会报告每个模型的上下文窗口。 模型与定价

托管开源权重模型除了在 /v1/chat/completions 上，也在 /v1/messages 和 /v1/responses 上作答，并支持你的系统提示词和工具调用。/v1/messages 接受 thinking，reasoning_effort 是请求字段。 模型与定价

/v1 上的错误响应体遵循 SDK 的结构：OpenAI 格式端点上是带 type 和 message 的 error 对象，/v1/messages 上则是同一对象位于 {"type": "error"} 之内。 错误处理

开放的流每 15 秒发送一次保活：/v1/chat/completions 上是 : ping 注释行，/v1/messages 上是 event: ping。 流式

工具调用 id 在 /v1/chat/completions 和 /v1/responses 上以 call_ 开头，在 /v1/messages 上以 toolu_ 开头。 函数调用

/v1/responses：stream 默认为 false。 Responses API

在 /v1/chat/completions 上，max_completion_tokens 作为 max_tokens 的另一个名称被接受。 Chat Completions

Responses 流的 response.completed 事件带有 output 数组。 Responses API

GET /v1/models 的条目带有 display_name、context_window、max_output_tokens、pricing、capabilities 和 endpoints。 模型与定价

每个回复都带有 x-request-id，你发送的值会被原样返回。请求体最大可达 32 MiB。

密钥可以被撤销而不签发新密钥。用量日志支持分页。

请求中的图片和文档：/v1/chat/completions 上的 image_url 部分，/v1/messages 上的 image、document 和 file 块，/v1/responses 上的 input_image 部分。 图片与文件

新模型 shannon-3-pro。 模型与定价

新模型 shannon-3。 模型与定价

/v1/chat/completions 上的流以 delta.reasoning_content 携带推理内容。 推理强度

max_tokens 保持在 1 到 65,536 之间。超出该范围的值会被调整到最近的端点值，而不是被拒绝。 Chat Completions

shannon-coder-1 在 /v1/chat/completions 和 /v1/messages 上按每个计划的调用次数计算。当一个窗口内的调用次数用完时，回复为 429，消息为 Shannon Coder call quota reached。 CLI 编程工具

超出上下文窗口的对话会得到 400 回复，类型为 invalid_request_error，代码为 context_length_exceeded。流内部的错误以错误事件的形式到达，而不是作为答案中的文本。 CLI 编程工具

/v1 端点：POST /v1/chat/completions、POST /v1/messages、POST /v1/responses 和 GET /v1/models。OpenAI 和 Anthropic SDK、Claude Code 以及 Codex CLI 调用的正是这些端点。 概览

在 /v1/chat/completions 和 /v1/messages 上通过 tools 进行工具调用，通过 response_format 实现结构化输出，并且 /v1/messages 上的 system 可为字符串或文本块。 函数调用

新增模型 id shannon-1.6-pro、shannon-2-lite、shannon-2-pro 和 shannon-coder-1，与 shannon-1.6-lite 并列。 模型与定价

API 首次发布：OpenAI 格式和 Anthropic 格式的聊天，以及 Responses 端点，均使用以 sk- 开头的 API 密钥调用。 认证