TypeSafe Jev 国内接入指南：直连、网关与实战方案

一、四种 TypeSafe Jev 接入渠道全景对比

自 2026 年 9 月 21 日 TypeSafe 取消候补名单（Waitlist）以来，开发者共有四条主流路径可以在生产环境中调用 Jev。对于中国团队而言，最核心的差异在于支付方式、网络连通性以及对 Jev 1.14 新特性的支持度：

• 路径 1：jevmodel.org 托管直连（推荐国内团队）—— 免海外卡，支持微信支付与 ¥49 起人民币流量包；注册送 10 万 token；100% 兼容原生 /v1/systemone 协议；内置 Jev 1.14 图像/Box/长上下文自动转发与失败自动退款。
• 路径 2：TypeSafe Console 官方直连（console.typesafe.ai）—— 刊例价 $0.042/百万输入 token，适合每月数十亿 token 且具备海外美金卡与合规主体的大型出海企业。
• 路径 3：OpenRouter（typesafe/jev-1.13）—— 适合已经在用 OpenRouter 统一管理多模型账单的团队，但需注意版本固定与专有字段映射。
• 路径 4：Vercel AI Gateway（typesafe-ai/jev）—— 适合 Next.js + AI SDK 全家桶用户，通过 experimental_evaluate 调用。

二、零改造兼容：一套代码同时支持 jevmodel 与官方直连

很多工程团队在评估期用 jevmodel.org 快速跑通业务验证，我们设计接口时的第一原则就是“零锁定（Zero Lock-in）”。你只需要把端点地址和密钥放进环境变量，请求 JSON 与响应解析逻辑一行都不用改：

# 只需修改环境变量中的 Base URL 与 Key，请求体 100% 兼容
# 方案 A：jevmodel.org 国内友好直连（支持微信支付 / 人民币，免翻墙）
export JEV_BASE_URL="https://jevmodel.org/v1/systemone"
export JEV_API_KEY="sk-你的-jevmodel-key"

# 方案 B：TypeSafe 官方直连（需海外信用卡与官方账号）
# export JEV_BASE_URL="https://api.typesafe.ai/v1/systemone"
# export JEV_API_KEY="ts-你的-typesafe-key"

curl -X POST "$JEV_BASE_URL" \
  -H "Authorization: Bearer $JEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "订单金额 ¥12,800，收货地址与常用城市不一致，且近 10 分钟修改过手机号。",
    "questions": {
      "risk_level": {
        "type": "score",
        "instructions": "评估该笔交易的盗刷风险",
        "criteria": ["正常交易", "轻度可疑，发短信验证", "高危交易，人工复核"]
      },
      "block_now": {
        "type": "noul",
        "instructions": "是否应在放行支付前立即拦截？"
      }
    }
  }'

三、接入 Jev 1.14（图像理解、Box 定位与 262k 长上下文）

TypeSafe 在 2026 年 10 月发布的 Jev 1.14（模型别名 jev-preview）补齐了视觉判断与超长日志分析。在官方直连时，你必须手动管理 TypeSafe-Danger-Zone-Images: true 和 TypeSafe-Danger-Zone-Long-Context: true 两个特殊请求头；而在 jevmodel.org 上：

• 只要你的请求体里带有 assets（base64 PNG/JPEG）或 box 问题，网关会自动帮你加上图像 opt-in 头。
• 当单题输入超过 30,000 token 或总输入超过 60,000 token 时，网关会自动开启 262k 长上下文模式。
• 任何付费账户（哪怕只买过一次 ¥49 入门包）都默认解锁 Jev 1.14 全部能力。

四、在 Claude Code / Cursor 中通过 MCP 接入 Jev

如果你在开发或使用 AI Agent，不需要手写 HTTP 代码。jevmodel.org 提供了现成的 Streamable HTTP 远程 MCP Server（https://jevmodel.org/mcp），与你的 API key 共用同一个 token 余额池：

# 1. 在 Claude Code 中一键接入 Jev 远程 MCP Server
claude mcp add --transport http jev https://jevmodel.org/mcp \
  --header "Authorization: Bearer $JEVMODEL_API_KEY"

# 2. 在 Cursor / Windsurf / Cline 的 mcp.json 中配置
{
  "mcpServers": {
    "jev": {
      "url": "https://jevmodel.org/mcp",
      "headers": {
        "Authorization": "Bearer sk-..."
      }
    }
  }
}