eu/jev：德国托管的 AI 文本分类与决策 API

eu/jev 是由 Bevelites GmbH 运营的 AI 决策服务，主要面向需要把文字转成结构化判断的开发者和业务团队。它提供文本分类 API：你给出上下文、问题和候选类别，服务返回选项、概率或评分，程序可以据此进行工单分流、情绪判断或内容审核。

用大白话说：eu/jev 这个网站是干什么用的？

可以把 eu/jev 理解为一个「阅读材料后按你给的规则做选择」的服务。

例如，客服收到一句「这张发票多扣了一次钱，请帮我处理」。你事先定义「账单问题」和「技术问题」两个类别，再把消息交给 eu/jev。它会给出分类结果及相关概率，供你的应用决定交给哪个团队。结果仍需要结合实际业务规则验证。

网站提供在线 Playground，方便了解这种输入和输出；更主要的使用方式是通过 API 把分类能力接到自己的应用中。它的主要输出是结构化决策，适合需要明确类别或分数的任务。

从工单分流到内容判断：怎样定义分类任务

eu/jev 的分类结果取决于你如何描述问题和选项。定义任务时，先说明希望做出的判断，再给每个类别写清含义。例如，工单分流可以区分付款、发票和退款问题，与故障、报错和登录问题。

除了选择负责团队，也可以根据评论内容判断情绪、按给定标准检查内容，或者对多个候选选项做判断。这里的能力来自服务对问题与标准的解释，不代表它已经连接了你的客服系统、审核后台或其他业务应用。把返回结果接到后续流程，仍需由你的程序完成。

适合它的读者主要是应用开发者，以及希望把分类结果接入现有流程的团队。使用前应准备代表性样例和人工确认过的答案，检查模糊表达、少见类别与边界情况，再决定哪些结果可以自动处理。

Choice、Noul、Score 分别返回什么

同一端点提供三种判断类型，但它们的结果不能当成同一种分数使用：

Choice 的 confidence 按相对于均匀猜测的程度归一化，和选中类别本身的概率是两个字段。Score 的范围由你给出的标准数量决定；例如，四个等级对应 0–3，不能统一理解成百分制。

这些数值是模型预测，需要在与你实际任务相近的数据上评估，才能用于设定自动分流或人工复核条件。

如何完成一次文本分类 API 请求

开始前，需要先取得获准使用的账号和 API key。当前服务会按容量审核访问申请，提交申请表并不意味着已经建立账号、获得密钥或取得额度。获准后，可在控制台获取密钥；密钥应保存在服务器端，避免放进浏览器代码或提交到代码仓库。

一次基本请求的准备步骤如下：

1. 准备需要分类的上下文，放进 state。它可以是字符串、JSON 对象或数组。
2. 在 questions 中为问题命名，指定 choice 类型、任务说明与类别含义。
3. 使用 Bearer 认证向官方端点发送 JSON 请求。
4. 先检查 HTTP 状态，再读取与问题名称对应的 answers，并检查分类和概率是否符合预期。

下面是根据官方格式编写的示例，请将占位符替换为自己的服务器端密钥：

curl https://eu-jev.com/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jeff-latest",
    "state": "这张发票多扣了一次钱，请帮我处理。",
    "questions": {
      "team": {
        "type": "choice",
        "instructions": "把这条客服消息分给最合适的团队。",
        "criteria": {
          "billing": "发票、扣款与退款问题",
          "technical": "故障、报错与登录问题"
        }
      }
    }
  }'

请求成功后，读取 answers.team.choice、answers.team.probabilities 和 answers.team.confidence。返回的类别名称与你定义的选项对应；上面的输入是说明格式的示例，实际预测可能变化。文档未给出完整语言支持清单，中文或其他语种应先用目标样例验证。这套步骤依据公开文档整理，本次收录调研未执行带真实密钥的调用。

返回信息还包含实际使用的模型版本、输入 token 用量、请求 ID 和成功请求的精确费用 meta.cost_eur。遇到持续失败时，请求 ID 可用于向官方定位问题。完整请求格式与 JavaScript、Python 示例见官方 API 文档。

免费额度、输入 token 计费与账号申请

以下计费条件于 2026 年 10 月 5 日核实，官网使用欧元：

• 获准的新账号有 €5 起始赠送额度，属于一次性促销余额，没有每月重置，也不会因余额不足自动扣款。
• 输入价格为每十亿 token €37。这里的「十亿」是 1,000,000,000；按相同单位计算，一百万输入 token 为 €0.037。
• 输出 token 免费，输入费用包括上下文、问题说明、候选类别与请求准备所需的特殊 token。同一次请求共享的 state 计一次，再加上各问题的输入。
• 重复或缓存输入仍按相同费率计费。系统在推理前检查并预留精确费用，只对成功返回的结果扣除额度；失败请求不消耗额度。
• 登录后的 Playground 与 API 共用账号余额。匿名 Playground 免费，但受独立的访客请求限制。

如果余额不足以覆盖一次请求，服务会在推理前停止，返回 HTTP 402 和 insufficient_credits，并提供申请额外用量的入口。当前条款没有自动收集银行卡或自动转为付费订阅的安排，付费使用需要另行明确约定。不要把起始额度理解成永久无限免费 API，也不要据此推断存在每月订阅套餐。

申请访问或额外用量可使用文末的官方申请表；付费、税费与其他约定以当前服务条款和另行签订的条件为准。

德国托管的范围：推理数据和账号数据要分开看

隐私政策说明，网站与 API 源站、应用数据库和模型工作进程部署在德国的 Hetzner，推理请求路径没有外部模型代理或 CDN。

提交的上下文、问题、类别标准和回答，不会保存在应用数据库或应用日志中，也不用于训练。不过，工作进程内存中的 token 或中间缓存可能跨请求保留，直到被覆盖、清除或进程重启；这与「请求结束后所有数据立即彻底删除」不同。浏览器中的 Playground 也会在页面打开期间保留输入。

账号信息、密钥哈希、额度记录、使用情况及安全元数据会保存。政策还说明，账号与用量记录没有按固定年龄自动清理的任务，不能把报表统计周期当成数据保留期限。

此外，可选的 Google 登录、验证或重置密码邮件、外部申请表，可能涉及欧洲经济区以外的处理，包括美国。因此，德国推理托管描述的是特定处理路径，不能概括为整个服务的所有数据只留在欧盟。完整范围见官方隐私政策。

企业处理个人数据前，需要先完成数据处理协议 DPA；匿名试玩应使用合成或不含个人信息的内容。敏感或高风险处理还需另行约定相应条件。DPA 是协议，不能当作认证；涉及重要后果的判断，也不应仅凭一次模型预测直接执行。

接入前要知道的限制与兼容边界

API key 和登录后的 Playground 共用 每账号每分钟 60 次请求的限制；匿名 Playground 为 每访客每分钟 12 次、每天 100 次，请求排在持有密钥的请求之后。

API 的 JSON 请求体最多为 256 KiB，字符串 state 最多 100,000 字符，单次最多 8 个问题。每条问题说明最多 1,000 字符，每项标准在序列化后最多 500 字符；准备后的输入还要符合 32,768 个位置的上下文分配。分支问题和格式也占用这个分配，达到字符限制不代表一定能放入模型。Playground 文本框另有 12,000 字符上限。

服务一次处理一个请求，高负载时可排队等待最多 20 秒，队列满时返回 503 和 Retry-After。遇到 429 应遵循重试等待；422 可能需要缩短或修改输入；不要在未检查状态时直接读取答案。返回的 latency_ms 也不是端到端延迟，不包含网络往返等全部时间。

eu/jev 使用自己的模型：jeff-latest 指向当前版本，也可以固定到文档支持的版本。它沿用 TypeSafe System One 的 HTTP 请求结构，但不支持 Jev 模型 ID，使用这类 ID 会返回 400。请求结构兼容不等于 SDK、结果、分词和额度完全相同，也不代表 eu/jev 是 TypeSafe 官方欧洲节点。

官方 FAQ 将 Winnow 列为基础模型；基础模型的开放情况并不能证明 eu/jev 托管服务的软件开源或允许自行部署。商业应用集成需要遵守服务条款。

常见问题

eu/jev 会生成文章，还是返回分类结果？

这里的主要用途是从已有上下文得到选择、是／否概率或有序评分。对于需要把客户消息归类、把内容转成结构化判断的应用，它的输出比长篇回答更容易接入程序；是否满足具体任务，仍需用样例验证。

使用 eu/jev 文本分类 API 需要先训练模型吗？

公开文档中的接入方式是使用现有服务，在请求里描述问题和类别，不要求你先训练自己的模型。你仍需要设计清晰的类别、准备测试样例，并具备有效账号与密钥。当前账号访问按容量审核。

分类概率或 confidence 很高，就一定判断正确吗？

不一定。概率和 confidence 是预测相关指标，含义也有差别；它们不等于你实际业务中的准确率。应比较代表性文本与人工确认答案，再决定自动处理阈值，并保留必要的复核流程。

€5 免费额度每个月都会恢复吗？

不会。获准的新账号只获得一次性 €5 促销余额。成功请求按输入 token 单价扣减，额外用量和付费条件需要另行明确约定，不是自动续费的月度套餐。

德国托管是否代表账号和登录数据也全部留在欧盟？

不能这样理解。德国托管描述的是文档中的推理基础设施，Google 登录、邮件和外部申请表可能涉及欧洲经济区以外的处理。企业使用个人数据仍需要 DPA。

官方资源与使用申请

• eu/jev 官方常见问题：了解基础模型、托管说明与兼容范围。
• 官方访问与额外用量申请表：申请加入等候名单或提出额外用量需求；提交不保证获准。
• 官方法律文件入口：查看运营方、条款、DPA 与分处理方信息。