Jev 上手排错指南：429 限流、waitlist 卡审与 OpenRouter 替代路径

「文档看不懂」「copy 这个 checklist 就行」（heyrobinai，2026-09-26）——Jev 上手期的社区讨论里，故障比功能出现得还频繁。这篇把高频故障按「进不了门 → 请求被打回 → 请求太慢被限」的顺序排成排查手册：社区案例给现象（均为当事人自述，本站逐字核验过出处），处理动作给官方口径。跑通第一个请求的基础步骤在中文上手教程，这里只管修。

申请了 waitlist 为什么还没过审？

直接回答：早期访问阶段官方没有公布任何审批时长承诺，而社区报告里最高频的故障其实是——资格已经放行，但确认邮件没收到。先直接登录控制台试一次，别干等邮件。

r/PiCodingAgent 的一手报告（所属帖 2026-09-16，评论经核验）：

429 是限流还是配额问题？

直接回答：是限流——官方按两个维度计量（250,000 tokens/s 与 1,200 requests/min），任一维度超限即返回 429 Too Many Requests；而且早期访问期限额动态调整，官方原话是「serving a very large volume of demand……limits above can change without notice」。

社区一侧，部署在 Vercel 上的服务打出一串 429（notifyShivam，2026-09-26，本站逐字核验：「oops jev is not working on @vercel and giving 429」）。这类场景的排查顺序：

1. 确认是限流不是故障——429 是官方文档明确的行为（超限返回），不是服务异常；先看响应有没有 retry-after 头。
2. 算一下两个维度——tokens/s 按请求的输入 token 计（usage.input_tokens 有回报），requests/min 按次数计。批量回填类任务最容易撞后者。
3. 部署平台多实例共享同一个 Key——1,200 requests/min 是账号维度，Vercel/Serverless 的并发实例会把量翻倍打上去。
4. 官方建议的高配额路径——「Higher limits are available on custom and enterprise plans. Contact [email protected].」（官方口径）。

重试的正确姿势官方已经替你写好：官方 SDK 默认带指数退避并尊重 retry-after 头；Python SDK 的 RetryPolicy 默认 max_retries=2、退避 0.5s 起步上限 5s（含抖动）、对 408/429/5xx 重试、respect_retry_after=True。要调就改 RetryPolicy，不要在业务代码外面包一层裸循环。

第一个请求就报错：请求体怎么写？

直接回答：最常见的原因是问题构造得不够显式——指令里没写明确条件、选项只给了短名单、或者把模型不擅长的事（算术、间接推理）丢给了它。

社区验证过的一句话（r/PiCodingAgent，评论经核验）：

You need to be rather explicit in the construction of your questions, but they have a TypeSafe skill that tells your LLM how to do that, so it’s not too bad. —— peepo_comfy

对应到官方文档，就是四条硬规则：

1. 写出精确条件——官方 jaggedness 页承认模型「字面理解」：它回答你写的问题，不是你想的问题。边界情形写进 criteria 描述里。
2. 选项给全清单——Choice 单问题最多 255 个选项，官方明确要求给完整清单而不是 shortlist；覆盖不了就加 other，别让模型硬选。
3. 算术放代码——「Jev is not a calculator」（官方 jaggedness 原文），数学比较、计数在代码里做。
4. 看清上下文预算——官方规格是单请求 64k token 总预算，其中 state 加最长问题占 32k。社媒流传的「32k 上限、无视觉」（如 theo 的转述）是社区说法，以官方 Models 页为准：64k/请求、32k（state+最长问题）、纯文本输入。

Jev is HERE. How to use it（Greg Isenberg 的上手向 walkthrough，观点为其个人表述） — YouTube

Jev is HERE. How to use it（Greg Isenberg 的上手向 walkthrough，观点为其个人表述）

等不及 waitlist？OpenRouter 的 Jev Router 是另一条路，但不是直连

直接回答：OpenRouter 上架了 TypeSafe 官方的 Jev Router——用 Jev 为每个请求挑选最佳模型和推理力度的网关产品。但注意：截至 2026-09-28，OpenRouter 模型列表里只有 typesafe/jev-router，没有裸 Jev 模型。想跑 POST /v1/systemone 的问答契约，还是要等 TypeSafe 的 API Key。

本站 2026-09-28 经 OpenRouter 公共 API 与产品页核验的事实：

• 模型 ID typesafe/jev-router，名称「TypeSafe: Jev Router」；
• 官方描述：「Jev Router picks the best model and reasoning effort for each request, balancing quality, speed, and cost. It runs on Jev, TypeSafe’s first System One model……One endpoint gives you the whole model ecosystem.」；
• 走 OpenAI 兼容的 chat completions 接口（model: "typesafe/jev-router"），路由层上下文 1M，计费为动态值（随被路由到的模型变化）。

「免等 waitlist、先走 OpenRouter」的社区说法（heysandy801）指的就是这条路。两种路径的差异要分清：

社区对 Router 的实测可以参考但要打折听：theo 自述花 $1,000 跑 DeepSWE 基准，「Performance on DeepSWE was roughly the same as GPT-6 Astra on low」（theo，2026-09-26，单点实测）；中文社区的提醒是路由本身有开销、切换模型也影响缓存命中（lnxi269983）。两者都是 community 观点。

哪些错误该重试、哪些必须改请求？

直接回答：限流与网络类错误重试（SDK 会自动做），请求构造类错误改代码——重试一个 400 只会被再打回一次。官方 Python SDK 的异常层级是排查地图：

自定义重试行为走官方 RetryPolicy（尝试次数、可重试状态码、退避与 retry-after 处理都可配），默认值见上一节。修好进门之后，建议先跑一个小黄金集再上生产——置信度阈值怎么定，见置信度校准实战；它是本站从这批社区翻车案例里提炼的另一篇。