选择模型

模型负责理解你提供的背景，并回答你定义的问题。同一个任务交给不同模型，可能得到不同结果。价格更高，也不代表在你的具体任务上一定更合适。

常见问题

Q: System One 提供哪些模型？
A: Jev、Clef、Clef Flash、Clef Omni、Clairic，用于托管决策与抽取。

Q: Clairic 与 Clef Flash 怎么选？
A: 需要类型化字段抽取用 Clairic；快速 Choice/Score/Noul 用 Clef Flash。抽取示例见 Clairic SDK 页。

查看当前可用模型

打开模型目录，查看目前提供的模型。登录后，可以在 Playground 中选择模型，尝试示例或自己的任务。

模型目录会持续扩展，也可能发生调整。本页介绍选择方法，不是固定的完整模型清单。使用前，请在产品中查看模型的当前信息：

以 System One 为该模型实际提供的能力为准。在其他地方看到某项能力，并不代表这里已经支持。目录暂时无法加载时，不要猜测模型 ID 或价格；请稍后重试，或联系支持。

图片与各模型限制

请读取 capabilities.inputs 中的 image 及对应 limits.images（count、bytesPerImage、totalBytes）。模型名称、ID 前缀及 SDK 版本不决定能力。支持图片的目录项（如 Clef、Clef Flash、Clef Omni）接受图片；仅文本的目录项（如 Jev、Decider）拒绝非空图片。Clairic 是抽取模型（返回带 confidence 和 p_null 的类型化取值），与上述决策模型互补；公开模型页已上线。在开放 API 调用之前，它不会出现在 GET /v1/models。通过 System One 使用公开名称 clairic 和 SDK extract() 调用。托管目录可增加其他兼容模型，无需修改应用代码。图片网关最高允许 PNG／JPEG／WebP、四张、单张解码后 4MB、合计 8MB，完整 UTF-8 JSON 最高 13MB；纯文本条目上限为 64KB。目录可以收紧限制。

在 Playground 中，先选择支持图片的模型，再添加本地图片文件。按提交顺序查看已附加图片，移除不需要的文件，并重新检查估算：图片 base64 字节计入积分。State 仍必填，但可以为空字符串。空图片列表是文本请求，不支持远程图片 URL、音频或视频。切换到纯文本模型时需先移除图片，不会静默丢弃图片。有决策图片时请使用 HTTP/curl 示例及说明，而不是 evaluate() 的 SDK 示例。Clairic 图片使用 extract()。参阅图片请求契约与 Fetch 示例及隐私指引。

用自己的任务比较模型

1. 准备几条有代表性的材料，其中包含一条模糊或较难的情况。
2. 写清楚问题和可选答案。可以先了解问题类型。
3. 在 Playground 中选择模型，点击下拉框旁的 模型信息 按钮查看限制和单价，检查预计积分后再运行请求。
4. 保持背景与问题不变，选择另一个模型；先查看新的预计积分，再运行比较。
5. 根据你期望的处理方式检查答案，同时比较错误、不确定性、耗时和积分消耗。

每次运行都是一次独立请求，可能消耗积分。结果和响应时间可能变化；一个示例成功，不代表模型每次都正确或快速。在处理重要任务或批量使用前，先小范围试用。

切换模型时注意什么

切换后，重新检查输入和预计费用。另一个模型可能要求更多候选项、更短的问题名称，或者必须填写问题说明。

输入被拒绝时，请按页面提示调整，不要原样反复提交。如果某个模型不再可用，从当前目录中选择替代模型，并重新测试任务效果，不要假定模型之间可以无差别替换。

在 SDK 或 HTTP 请求中选择模型

从当前目录复制完整模型 ID，填入 SDK 或 HTTP 请求的 model 字段。不要用显示名称、旧示例中的 ID 或猜测的简称代替。希望明确控制所用模型及费用时，请显式选择模型；留空会使用服务当前的默认模型。

通过公开的 GET /v1/models 获取当前目录。该请求不需要 API 密钥，也不消耗推理积分。目录条目可以提供模型 ID、能力、限制和积分价格。也可在 /zh-CN/models 浏览同一批已上架模型。响应格式见 API 参考，客户端接入见 SDK 文档。通过 SDK 直连其他服务时，以该服务的模型目录为准；本站目录并不代表所有 SDK 适配器支持的模型。

切换模型属于一个不同的任务，需要使用新的幂等键。如果上一次请求的结果还不确定，应先核对或恢复该请求，不要直接换模型反复重试。

接下来

• 用 Clairic 抽取类型化字段。
• 通过 SDK 调用托管 API。
• 理解选项、评分和概率。
• 了解积分如何计算。