功能

所有模型都通过相同的三个端点、使用相同的密钥访问。两张表展示了模型之间的差异。破折号表示该模型在没有该功能的情况下作答。

Shannon 模型

托管开源权重模型

托管模型的 id 由其名称和变体以连字符连接而成，例如 DeepSeek-V4-Pro-0813-3BIT-REAP。

各列的含义

• 工具. 你在 tools 中描述函数，模型回复它想要发起的调用，由你的代码运行。所有模型都支持工具。托管开源权重模型会应用强制的 tool_choice。 函数调用
• 图片输入. 模型可读取用户消息中以 data URL 或地址形式发送的图片。shannon-2-lite 和 shannon-2-pro 在同时发送 tools 或 response_format 的请求中也能读取图片。Shannon 3 系列还能读取文档。 图片与文件
• 推理. 回复中可以在答案旁边，用单独的字段携带模型的推理文本。 推理强度
• 推理强度. 通过请求字段设定模型推理的深度：off、low、medium 或 high。Shannon 模型自行决定深度。 推理强度
• JSON 对象. 使用 response_format: {"type": "json_object"} 时，答案是 JSON，但没有规定的结构。适用于 /v1/chat/completions 和 /v1/responses。 结构化输出
• JSON schema. 当 response_format 的类型为 json_schema 时，答案遵循你发送的 schema。适用于 /v1/chat/completions 和 /v1/responses。 结构化输出
• Prompt 缓存. 开头与同一模型上近期 prompt 相同的 prompt 会从缓存读取，缓存部分按输入价格的 25% 计费。无需任何请求字段。 Prompt 缓存
• 网页搜索. 使用 web_search: true 时，API 会先搜索网页，并在模型回答前把结果交给它。适用于 /v1/chat/completions 和 /v1/messages。它是请求的字段，在 GET /v1/models 中没有对应标志。 内置网页搜索
• 流式传输. 使用 stream: true 时，回复会在模型写作的同时以 server-sent events 形式到达。所有模型在三个端点上都支持流式传输。 流式

从 GET /v1/models 获得相同的信息

GET https://api.shannon-ai.com/v1/models

GET /v1/models 列出每个模型及其 capabilities 对象，因此程序可以直接读取这些信息，而不必看本页。该端点无需密钥。

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.shannon-ai.com/v1")

for model in client.models.list():
    print(model.id, getattr(model, "capabilities", None))

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://api.shannon-ai.com/v1" });

for await (const model of client.models.list()) {
  console.log(model.id, model.capabilities);
}

curl https://api.shannon-ai.com/v1/models

data 中两个条目的 id 和 capabilities：

[
  {
    "id": "shannon-3",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": false,
      "streaming": true,
      "json_schema": true
    }
  },
  {
    "id": "Kimi-K3-3BIT-REAP",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": true,
      "streaming": true,
      "response_format": true,
      "json_schema": true,
      "prompt_caching": true
    }
  }
]

• response_format 和 prompt_caching 是托管开源权重条目的标志。Shannon 条目只用 json_schema 表示 JSON 输出，它同时代表两种 JSON 模式。
• shannon-2-lite 和 shannon-2-pro 的 vision 为 true：在同时发送 tools 或 response_format 的请求中，它们也能读取图片。

超出模型所在行的情况

托管开源权重模型会拒绝超出其所在行的图片或 JSON 模式。拒绝发生在从你的余额中扣除任何内容之前：

Shannon 模型对此类请求返回状态码 200：超出其所在行的功能不会参与回答。 错误处理