Jev API 渠道怎么选：官方 API vs OpenRouter
Jev 到你手上有两扇门：官方 TypeSafe AI 渠道和 OpenRouter——模型的主演示渠道。两者都说 OpenAI 兼容的请求/响应”方言”，所以选哪个都不会被锁死；但在接入速度、计费方式和看到新版本的早晚上有实质差异。这篇做完整对比，并按项目阶段给出具体建议。
TL;DR： 先用 OpenRouter：路径最短，按 token 计费（第三方列表约 $0.0462 / 1M input tokens——以模型页为准）。当你需要企业条款、直连支持或版本保障时再考虑官方渠道；其端点以 typesafe.ai 文档为准。把所有 Jev 调用收敛到一个 client 函数后面，日后切换只是一个下午的事，不是一次重写。
两个渠道对比
| 维度 | OpenRouter（演示渠道） | 官方 TypeSafe AI API |
|---|---|---|
| 接入速度 | 几分钟：注册、充值、拿 Key | 较慢：按官方文档走开通流程 |
| 请求格式 | OpenAI 兼容 chat completions | 以 typesafe.ai 文档为准 |
| 定价 | 按 token 计费；列表价约 $0.0462 / 1M input tokens（第三方数据，以模型页为准） | 按官方条款；查 typesafe.ai |
| 计费方式 | OpenRouter 预充值，可按 Key 设消费上限 | 以官方计费安排为准 |
| 版本可用性 | 模型页列出；slug 可能领先或滞后官方文档 | 第一手；以官方发布说明为准 |
| 支持 | 市场级别 | 直连，按官方渠道 |
| 适合 | 原型、中小规模生产、快速实验 | 企业负载、合规需求、量级承诺 |
两个诚实的提醒。第一，模型 id 在两个渠道可能不同——typesafe/jev-1.13 是写作本文时 OpenRouter 的列表值，slug 会随版本变化，以模型页为准。第二，本文刻意不编造官方端点 URL；官方渠道提供什么，typesafe.ai 的文档是唯一事实来源，介绍 System One 模型与 Jev 的发布公告也是。
OpenRouter 实际用起来什么样
一次调用、一个 Key、你熟悉的端点：
# Confirm the exact model slug on the OpenRouter model page
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "typesafe/jev-1.13",
"messages": [{"role": "user", "content": "Choice question: route this email to sales, billing or support? Email: \"...\""}]
}'标准 chat completions 请求——分流语义由问题的措辞承载。
解析后的答案——示例数据（example fixture），正式字段名以官方文档为准：
{
"answer": "billing",
"confidence": 0.94,
"rationale": "The email disputes a subscription charge, which maps to the billing queue."
}这正是推荐先用 OpenRouter 的原因：你现有的 OpenAI 客户端库、重试逻辑和观测手段全都原样可用。
迁移成本：架构对了就很低
切换成本大多是自找的，也就大多可以避免：
- 一个 client 函数。 所有 Jev 调用走同一个封装：进一个问题，出解析后的答案。
- base URL、Key、模型 id 全部走配置。 用环境变量，不写字面量。
- 容错解析。 防御式解析 message content；多出来的未知字段当可忽略，不要当致命错误。
有了这个结构，从 OpenRouter 迁到官方渠道就是改三个配置值、再对照官方文档核对一遍字段名——上面那个响应形态是示例数据（example fixture），官方渠道的确切字段名以其文档为准。
按阶段给建议
| 阶段 | 渠道 | 理由 |
|---|---|---|
| 评估 / 原型 | OpenRouter | 最快跑通 |
| 早期生产 | OpenRouter | OpenAI 兼容生态，可按 Key 限消费 |
| 规模化 / 企业 | 官方 API（评估后） | 支持、条款、版本保障——去 typesafe.ai 核实 |
| 混合 | 任一 | 保留封装层，按负载路由 |
三团队邮件分流的 case 展示了 OpenRouter 路径撑起生产负载的样子。钱的层面怎么算，《Jev 成本与延迟》把 token 经济学摆给你看。
本文适用版本 Jev 1.13。