jev模型不支持文本生成，仅处理结构化输出请求。必须明确问题类型（是非/选择/打分）、用json schema定义答案形状、输入纯utf-8文本。接入方式按推荐排序：vercel ai gateway最快，openrouter适合调试，官方申请支持压测，python工程可用sdk。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
新手入门Jev模型，最怕花三天学会调用接口，结果发现传进去的JSON结构错了一处字段名，返回空响应还查不出错在哪——因为Jev根本不报语法错误，它只沉默跳过非法schema。
先搞清它不是什么
别在Jev里尝试让它写一封道歉邮件、解释量子纠缠、或把会议纪要转成PPT大纲。它没有文本生成能力，【所有输入必须提前声明输出结构】，否则请求直接被拒，不提示、不报错、不重试。
打开TypeSafe官网文档首页，第一行加粗写着：“No free text. No open-ended questions.” 这不是提醒，是铁律。
必须掌握的三项硬前提
第一步：确认你手头的问题能被拆成“是非/选择/打分”三类之一。比如“这段用户投诉是否需要升级为VIP工单”，就是是非题；“该调用哪个风控模型：A/B/C/D”，就是选择题；“当前API请求风险等级（1～5）”，就是打分题。
第二步：用JSON Schema定义好答案形状。例如选择题必须写明"choices": ["A", "B", "C", "D"]，少一个引号、多一个逗号，Jev就当没看见这个字段。
第三步：把原始材料（日志、短信、SQL语句、工单描述）和问题拼成一段纯文本，不能带base64、不能嵌套二进制、不能混入HTML标签——Jev只吃干净的UTF-8文本，连BOM头都会导致概率值全为0。
四种接入方式实操排序
① 用Vercel AI Gateway（最快上手）：注册Vercel账号→进入AI Gateway控制台→添加模型typesafe-ai/jev→复制API KEY→用curl发POST请求。全程5分钟，不用等审核，9月25日前免费。
② OpenRouter（免代码调试）：注册后直接进Playground，选模型typesafe/jev-1.13，粘贴JSON payload就能看响应。适合验证schema是否合法，但无法设超时或重试策略。
方法三：TypeSafe官方申请（拿真金白银跑压测）：提交表单后几小时内过审，账户自动到账5美元余额。控制台自带实时token计费面板，能看到每次请求精确花了$0.00038还是$0.00041。
方法四：自己搭SDK（仅限已有Python工程）：pip install openai →把openai.base_url设为https://api.typesafe.ai/v1 →model参数填jev-1.13。注意别漏掉headers里的Authorization: Bearer sk-xxx，漏了会返回401且不提示缺密钥。
