Nutrient AI Gateway 提供两类原语，均为纯 REST API，不附带脚本，可用项目现有语言编写调用。
用途 AI Gateway 用于对内容做判断，而非解析文档：需要开放式生成、摘要、起草或工具调用时用聊天模型；需要“是/否”判断、分类、路由、标记复核或评分时用决策 API。文档结构化提取（字段、表格、引用）不属于本服务，应使用配套的 document-extraction-api 技能。
主要能力 聊天模型 nutrient-s / nutrient-m / nutrient-l 兼容 OpenAI：发送常规 Responses 或 Chat Completions 请求即可获得常规响应。新集成建议使用 /responses，它支持模型公布的推理级别以及函数工具。在线密钥接受内联或 URL 图片（/chat/completions 每请求最多 10 张图片、内联 data URL 最大 7 MiB、远程 URL 最大 4096 字节）；测试密钥仅文本。 决策模型通过 POST /systemone 调用，一个请求可携带多个命名问题，针对同一共享 state（任意 JSON：字符串、对象或数组）独立求值：
- noul：返回 {noul}，即答案为“是”的 0 到 1 概率，不是布尔值。
- choice：返回 {choice, confidence, probabilities}，choice 为 criteria 中的一个标签，probabilities 将每个标签映射到其概率。
- score：返回 {score, confidence, legend, probabilities}，score 为概率加权指数（例如 3 级量表上的 1.43），不一定是整数；legend 将每个从 0 开始的索引映射到 criteria 标签；probabilities 以索引为键，而非标签。 两个决策模型：nutrient-document-decision（推荐，Nutrient 自有模型，运行于 Nutrient 基础设施，接受以 {"type":"image","source":"data:<mime>;base64,<bytes>"} 形式嵌入 state 任意嵌套深度的图片，并连同周围文本一并评估）；nutrient-systemone（第三方提供商模型，仅文本，嵌入图片会被拒绝）。两者标签/等级上限不同：nutrient-systemone 支持最多 255 个 choice 标签、2–10 个 score 等级；nutrient-document-decision 最多 26 个 choice 标签、2–26 个 score 等级，每个选项须分词为单个原生标签；超出限制返回 HTTP 400 与 upstream_rejected_request。
使用方式 在 AI Gateway 仪表板创建 API 密钥，导出为 NUTRIENT_API_KEY="pdf_live_..."；pdf_test_... 测试密钥在组织启用测试密钥访问时可不扣减额度发起真实提供商请求。端点基址为 https://api.nutrient.io/ai/v1，用于 /responses、/chat/completions、/systemone 和 /models。切勿记录、回显或提交密钥，仅在可信后端代码中使用，不要用于浏览器、移动应用或客户端代码。文档给出三个 curl 示例：用 nutrient-document-decision 结合内嵌页面图片判断发票金额是否合理（noul），对事故文本按 low/medium/high/critical 评分（score），以及用 nutrient-m 的 /responses 重写事故说明。
适用场景与最佳实践 决策 API 旨在替代脆弱代码：noul 问题替代关键词匹配的 if/else，choice 问题替代易碎的分类器或查找表，score 问题替代手工调校的启发式刻度。建议将问题与阈值集中在一个可审查的文件中；noul 是概率而非裁决，应基于自身评估数据选择阈值，并将边界结果路由人工复核，不要硬编码 0.5。若只需“选最佳”，取 probabilities 中最高值标签，而非设置任意置信度下限；置信度阈值仅用于决定“是否应当处理”。上线前用少量真实示例验证问题措辞与结果是否符合预期。
限制与常见问题 nutrient-document-decision 支持图片但标签/等级上限较小（26），nutrient-systemone 仅文本但上限较大（255 标签、10 个 score 等级）；应按请求实际需要选择，并通过 GET /models 确认调用密钥实际可用的能力，不要假定两者功能对等。不要把 noul 当作布尔值，也不要假设 score 恰为整数等级，应显式取整或分桶后查 legend；score 的 confidence 与 choice 的 confidence 不可跨问题类型比较。若发现技能中引用了与本文或 API 参考不符的字段或端点，可能技能已过期，应重新获取。更多指南、完整 OpenAPI 架构和 API 密钥入口分别见 https://www.nutrient.io/guides/dws-ai-gateway/、https://www.nutrient.io/api/reference/ai-gateway/public/openapi.yml 和 https://dashboard.nutrient.io/ai-gateway/api_keys/。