模型与价格：版本、上下文限制、费率

Jev 价格、模型版本、上下文限制、速率限制——这些「数字型事实」收进一页速查。主要出自官方 models 文档（本地信息源 sources/jev/docs/models.md）与官方博文，更新时间 2026-11-04，当前最新稳定版 jev-1.14.0（2026-10-14 发布）。8 分钟翻完，做预算、选版本、排限流都够用。

学完你能做什么

• 一张表查出 Jev 两个在售版本（jev-1.14.0 / jev-1.13.0）的 Jev 价格、上下文与输入限制
• 算出一次请求的成本：$42 每 10 亿输入 token、输出免费，官方实例一次请求约 $0.000018
• 分清 64k / 32k 两个上下文限制各管什么，需要长文档时用请求头打开 262k
• 决定 model 字段填 jev-latest 别名还是锁定版本 ID，并知道 429 去哪查额度、怎么提额
• 用 GET /v1/models 列出你的账号能用的模型

你现在的困境

• 项目要接 Jev，预算表不知道填多少——「按 token 计费」到底输入算钱、输出算钱，还是都算？
• 64k、32k、262k 三个数都在文档里见过，不知道哪个管哪个，超了报 400 还是 429 也分不清
• jev-latest、jev-preview、jev-1.14.0 一堆名字，不知道 model 字段该填哪个，怕新版本一发布答案悄悄变

什么时候用这一招

当你需要：

• 接入前做预算：把 Jev 价格换算成「一次请求 / 一天用量」的成本
• 选版本：别名省心还是版本 ID 稳妥，调过阈值的该怎么锁
• 排限流：429 了去哪查额度、走什么表单提额

而且不想：

• 翻英文官方文档逐页找数字——这一页就是那张「数字总表」
• 上线后才发现中文内容没测过准确度，阈值全要重调

🎒 开始前的准备

• 完成了 注册与 API Key：有可用 Key，知道速率限制在控制台 /rate-limits 页查
• （可选）跑过 第一个请求：见过 model 字段和 raw 响应长什么样
• （可选）想跟着列模型：装好 typesafe-sdk（Python ≥ 3.10），或系统里有 curl

核心思路

TypeSafe 价格与限制的官方事实基本都出自同一页文档：docs.typesafe.ai/models。三个设计决定了你怎么花钱：

设计	一句话	对你的意义
按输入计费	输出 token 免费	省钱靠少发输入，不靠少收输出
两个上下文限制	per-request 64k / per-question 32k	限制的是体积，不是题数——题数无上限
别名会移动	jev-latest 随新版本切换	要稳定就锁定版本 ID

官方模型总表（价格与限制两个版本完全相同）：

	Jev 1.14	Jev 1.13
Model ID	jev-1.14.0	jev-1.13.0
价格（每 Btok / 每 Mtok）	$42 / $0.042	$42 / $0.042
上下文长度	64k per-request / 32k per-question	64k per-request / 32k per-question
输入	文本	文本

• Jev 1.14 是最新 Jev 版本，2026-10-14 起可用；1.13 是上一版。
• Btok = 10 亿 token，Mtok = 100 万 token。
• 输入形态：字符串、JSON 对象或文本数组；不接受音频、视频——先转成文本或结构化字段再当 state 发。

💡 官网首页的对比数字

TypeSafe 官网首页标价就是 $42 / 10 亿输入 token，并给出对比标语「输入价格比 Claude Fable 5.1 低 238 倍」。这是厂商自己的营销对比，写进预算前建议按自己的实际用量算一遍。

⚠️ 图像是 danger zone 实验特性

models.md 总表把输入写成 Text，但官方 images 文档明确支持图像：加 TypeSafe-Danger-Zone-Images: true 请求头后，state、instructions、criteria 里都能放图；Box 题型仅 jev-1.14.0 启用。官方博文明说这三个实验特性「毛边太多，不敢为生产场景背书」。图像用法详见 Box 与图像。

跟我做

第 1 步：查 Jev 价格计费规则——输入计费、输出免费

为什么：接预算前先弄清计费口径——Jev 只按输入 token 计费，输出 token 免费，这直接决定成本模型怎么建。

计费项	费率	说明
输入 token	$42 / Btok（$0.042 / Mtok）	请求发出去的内容（state + 问题）计入输入
输出 token	免费	答案、概率、confidence 都不收钱

换算速查（按 $0.042 / Mtok）：

一次请求的输入 token	成本
1 万	$0.00042
100 万	$0.042
10 亿	$42

你应该看到：预算公式就一行——单次成本 = 输入 token 数 × $0.042 / Mtok，输出不用管。

官网目前把 Jev 标为 early access（早期访问）阶段。

第 2 步：算一次请求的成本——usage 字段与批量省钱

为什么：成本不用估算——每个响应都自带 usage 字段，官方 API 规范里 input_tokens 的描述就是「计费输入 token 数」。

官方 quickstart 的工单分类请求（3 个问题，model 填 jev-latest）raw 响应实例——示例录制时 jev-latest 还指向 1.13，现在同样的请求会返回 jev-1.14.0：

{
  "model": "jev-1.13.0",
  "answers": { "...": "..." },
  "usage": {
    "input_tokens": 428,
    "output_tokens": 73
  }
}

你应该看到：usage.input_tokens: 428——按 $0.042 / Mtok 换算，这次请求成本约 $0.000018（约千分之二美分）。output_tokens: 73 免费。

省钱的关键机制：Jev 一次请求只「读」一遍 state，所有问题并行对着同一份 state 评估——加问题几乎只多花问题本身的 token。官方 cookbook 实测（13 个问题的 GDPR 监管简报案例）：

方式	成本	速度
13 次独立请求	1x	1x
1 次请求 13 个问题	便宜 12.2x	快 10.0x

答案不变。出处：docs/cookbooks/parallel_questions.md（docs/primitives.md 引用同一实验时写 11.5x / 9.6x，以 cookbook 原文为准）。实战见 并行提问与投机扇出。

第 3 步：核对 Jev 上下文限制：64k、32k 与 262k 长上下文

为什么：超上下文是 400 报错（max_tokens_exceeded），不是 429 限流——分不清的话排错方向就错了。

两个默认限制：

限制	含义	默认值
per-request context	state + 全部问题加起来	64k token
per-question context	state + 任意单个问题	32k token

• 问题数量本身无上限——只要塞得进这两个限制，一次请求想问几问都行。
• 超出上下文 → 400，报错码 max_tokens_exceeded（完整状态码表见 API 速查）。

长合同、长转录、长记录塞不进默认限制时，用请求头逐请求打开长上下文：

curl https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "TypeSafe-Danger-Zone-Long-Context: true" \
  -d '{
    "model": "jev-latest",
    "state": "<一份长合同、转录或记录>",
    "questions": {
      "has_termination_clause": {
        "type": "noul",
        "instructions": "Does the `state` include a clause that lets either party end the agreement early?"
      }
    }
  }'

你应该看到：带这个头的请求，per-request 和 per-question 限制都变成 262k token；不带的请求保持默认 64k / 32k。

长上下文三件事（官方原话）：

• 价格不变——每 token 同价
• 更慢、更不准——只给需要的请求用
• Jev 1.14 和 1.13 都支持

第 4 步：选对 model 字段——jev-latest 别名还是锁定版本

为什么：别名会随新版本移动，答案可能在你代码零改动的情况下变化；调过阈值的系统要的是「不变」。

名字	当前指向	含义
jev-latest	jev-1.14.0	最新稳定官方版；SDK 默认，官方文档示例都用它
jev-preview	jev-1.14.0	最新版本（含非官方 preview）；有 preview build 时会跑到 jev-latest 前面

⚠️ 官方警告：jev-preview 当前与 jev-latest 指向同一模型，现在没有 preview build。

版本管理三招：

• 每个响应的 model 字段给出实际应答的版本 ID——记日志时把它记下来
• 调过 confidence 阈值 → model 字段直接填版本 ID（如 jev-1.14.0），准备好再切
• Python SDK 默认模型可用环境变量 TYPESAFE_DEFAULT_MODEL 改（默认 jev-latest）

版本时间线（官方博文，2026-10-14）：

• jev-1.14.0 发布于 2026-10-14；博文说 jev-latest 一周后切到 1.14.0——本站信息源快照（2026-11-03）里已经切换
• jev-1.13.0 会保留一段时间
• 弃用预告：官方计划 1.13.0 正式弃用前给 60 天公告、1.14.0 给 30 天；弃用政策会在那之前发布

你应该看到：model 字段二选一——jev-latest（省心，跟着官方走）或 jev-1.14.0（稳定，调过阈值选这个），日志里能对上每次响应的版本 ID。

第 5 步：查速率限制与提额方式

为什么：速率限制按组织计，超限返回 429——先知道额度在哪查，跑批量任务不慌。

项	规则
计费单位	按组织（organization）
限制维度	tokens/s + requests/s
超限返回	429 Too Many Requests
查当前额度	console.typesafe.ai/rate-limits
SDK 行为	默认自动指数退避重试，并遵循 retry-after 响应头
直连 HTTP	429 / 529 自己写指数退避（见 API 速查）
提额	custom / enterprise 计划；官方申请表单

具体限额数值因组织而异，官方文档未公布默认值——以控制台 /rate-limits 页显示为准。

你应该看到：429 时打开控制台 /rate-limits 页就能看到当前组织的限额；用官方 SDK 的话默认自动重试，不用自己写退避。

第 6 步：查语言支持、数据处理与定制方式

为什么：中文用户上线前必读——CJK 准确度低于英语；企业合规要看数据处理条款。

项	官方规则
语言支持	英语是主要训练语言、准确度最好；其他语言（含 CJK 中文）能用但准确度较低——上线前用自己的内容测，路由时重点关注 confidence
1.14 的多语言	官方博文：1.14 是「小而稳的全面改进」，预期最大增益在多语言支持
数据处理	不用客户请求 / 响应训练；企业版有 ZDR（零数据保留），条款见官方 legal 页
定制方式	不做客户数据微调 / LoRA；所有账户共用同一组权重（RLCD 训练）；领域定制靠 state / instructions / criteria，复杂判断拆原子题、代码加权合并

你应该看到：中文场景上线前的两张核对表——准确度自测（用自己的数据跑、重点看 confidence）与合规确认（不用客户数据训练、企业版 ZDR）。

第 7 步：用 GET /v1/models 列出账号可用的模型

为什么：别名列表会变，脚本里动态列一遍比硬编码稳。

curl https://api.typesafe.ai/v1/models \
  -H "Authorization: Bearer $TYPESAFE_API_KEY"

Python：

from typesafe_sdk import TypeSafeClient

with TypeSafeClient() as client:
    for model in client.models.list().models:
        print(model.name, model.release_date, model.description)

JavaScript：

import { TypeSafeClient } from "@typesafe-ai/sdk";

const client = new TypeSafeClient();
const models = await client.models.list();
for (const model of models) {
  console.log(model.name, model.release_date, model.description);
}

你应该看到：每项含 name（模型 ID 或别名）、description、release_date。当前列表列出的是别名；版本 ID（如 jev-1.14.0）无论是否出现在列表里，model 字段都接受。

检查点 ✅

• 我能说出 Jev 价格：$42/Btok（$0.042/Mtok），输入计费、输出免费
• 我知道 64k 管「state + 全部问题」、32k 管「state + 单个问题」，问题数无上限
• 我知道长上下文要加 TypeSafe-Danger-Zone-Long-Context: true（262k，价格不变、更慢更不准）
• 我知道 jev-latest 当前指向 jev-1.14.0；调过阈值就锁版本 ID，并记响应的 model 字段
• 我知道 429 去控制台 /rate-limits 查额度；SDK 默认自动重试；提额走官方表单

踩坑提醒

❌ 按「输入 + 输出」做预算

Jev 输出 token 免费，只按输入算：一次 1 万输入 token ≈ $0.00042。把输出也计价会高估成本——响应里的 usage.output_tokens 只是参考，不计费。

❌ 拿着 jev-latest 调阈值，新版本一发布答案全变

别名随版本移动是官方设计。调过 confidence 阈值的系统，model 字段锁版本 ID（jev-1.14.0），响应里的 model 字段记进日志，准备好再切新版本。

❌ 超上下文当成限流去查额度

超上下文返回 400（max_tokens_exceeded），限流才是 429。看到 400 先量 state + 问题的体积，别去 /rate-limits 页瞎折腾。

❌ 中文内容不测就上线

官方明说 CJK 准确度不如英语。上线前用自己的中文数据测一遍，路由阈值按实测调，重点看 confidence。

进阶技巧（可选）

🔧 给长上下文降本：长上下文价格不变但更慢更不准——官方建议只给需要的请求开。大文档先在代码里过滤、只发该题需要的字段（官方 jaggedness 文档的推荐做法）；过滤不了再用 Noul 做相关性闸门（RAG cookbook 的做法）。两招详见 Jev 踩坑手册。

🔧 按 usage 记账：把每个响应的 usage.input_tokens 累计进日志，乘以 $0.042 / Mtok 就是分毫不差的账单口径——不用自己估算 token 数。

本课小结

✅ Jev 价格一页记住：$42 每 10 亿输入 token（$0.042/Mtok），输出免费；官网对比标语「比 Claude Fable 5.1 输入价低 238 倍」。

✅ Jev 上下文限制两个：per-request 64k、per-question 32k，题数无上限；长上下文头打开后都是 262k，价格不变、更慢更不准。

✅ 版本与别名：jev-1.14.0（2026-10-14 发布）是当前稳定版；jev-latest 已指向它；调过阈值锁版本 ID。

✅ 速率限制按组织计（tokens/s + requests/s），429 去控制台 /rate-limits 查，SDK 自动重试，提额走表单。

✅ 中文内容上线前自测（CJK 准确度较低）；不用客户数据训练，企业版有 ZDR。

关键数字回顾：

项	值	出处
价格	$42/Btok = $0.042/Mtok，输入计费输出免费	docs/models.md
上下文	64k per-request / 32k per-question	docs/models.md
长上下文	TypeSafe-Danger-Zone-Long-Context: true → 262k	docs/models.md
当前稳定版	jev-1.14.0（2026-10-14）	docs/models.md、官方博文
别名	jev-latest / jev-preview → jev-1.14.0	docs/models.md
速率限制	按组织，tokens/s + requests/s，超限 429	docs/models.md
列模型	GET /v1/models	docs/models.md
单次成本核对	响应 usage.input_tokens × $0.042/Mtok	docs/api/system-one.md

下一课预告

速查手册翻完，下一课 更新日志：Jev 模型与 SDK 版本时间线。你会学到：

• jev-1.14.0 发布时间与 danger zone 三特性（Images / Box / Long-Context）
• jev-latest 何时切到新版本、弃用预告政策（60 天 / 30 天）
• typesafe-sdk Python / JavaScript 各版本新增了什么
• 怎么第一时间知道自己的版本受不受影响

相关教程

• API 速查：请求、响应与报错
• 并行提问与投机扇出：一次请求问 13 个问题
• 注册与 API Key：5 分钟拿到 TypeSafe 钥匙

附录：源码参考

点击展开查看官方文档出处

更新时间：2026-11-04（官方文档本地信息源 sources/jev/docs/，URL = https://docs.typesafe.ai/<本地路径>）

内容	文件路径	关键位置
模型总表、价格、上下文、长上下文、速率限制、别名、语言支持、数据处理、定制方式、列模型	docs/models.md	Current models 表；Context length / Long context（curl 示例、262k、更慢更不准）；Rate limits；Aliases 表与 WARNING；Customizing Jev；Language support；Data handling；Listing models（curl / Python / JS 示例与 name / description / release_date 字段）
响应 usage 字段（input_tokens 计费 / output_tokens 免费）与 model 字段	docs/api/system-one.md	SystemOneResponse：model（「可能与请求别名不同」）、answers、usage（required）
usage 实例（input_tokens 428 / output_tokens 73）	docs/introduction/quickstart.md	Raw Response 折叠块
400 max_tokens_exceeded、429/529 指数退避	docs/api/errors.md	状态码表；Handling rate limits
SDK 默认模型环境变量	docs/sdk/python/usage/basic.md	TYPESAFE_DEFAULT_MODEL（默认 jev-latest）
13 问合并请求实测（12.2x 便宜 / 10.0x 快）	docs/cookbooks/parallel_questions.md	成本与时间对比
图像 danger zone 头	docs/images.md	TypeSafe-Danger-Zone-Images: true；缺头 400
1.14 发布、别名切换、弃用预告、多语言增益、Box 仅 1.14	官方博文 typesafe.ai/blog/jev-1-14（本地 site/jev-1-14.md）	2026-10-14 发布；jev-latest 一周后切 1.14.0；60 / 30 天弃用预告；「预期最大增益在多语言」；Box 仅 jev-1.14.0 启用
官网首页标价与 238x 对比、early access	typesafe.ai 首页（本地 site/home.md）	$42 / B 输入 token；「238x Lower input price than Claude Fable 5.1」；meta「in early access」