完成第一次调用：HTTP、Python 与 JavaScript

先明确：哪里会产生费用

本章代码在你自己的终端运行，调用你的账户。本站没有运行这些真实请求，也不提供代充。页面演示与返回值示意不等于实际测试结果。

最小请求

{
  "model": "jev-1.13.0",
  "state": "客户说：我还没有收到包裹，请查询物流。",
  "questions": {
    "asks_shipping": {
      "type": "noul",
      "instructions": "Does the customer ask about delivery or shipping?"
    }
  }
}

把它保存为 request.json，密钥已设置为环境变量时调用：

curl --fail-with-body https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

Windows PowerShell 可直接运行下面的 Python 示例，避免照抄 Bash 的换行与变量语法。下载包提供 examples/jev_client.py，没有环境变量时会在终端隐藏输入密钥。

Python 官方 SDK

需要 Python 3.10 或更新版本。先设置 TYPESAFE_API_KEY；将代码保存为 first_call.py，安装依赖后运行 python first_call.py。

python -m pip install typesafe-sdk

from typesafe_sdk import Noul, TypeSafeClient

with TypeSafeClient() as client:
    result = client.system_one(
        model="jev-1.13.0",
        state="客户希望查询尚未送达的包裹。",
        questions={"shipping": Noul(
            instructions="Is this a request about delivery?"
        )},
    )
    print(result.answers["shipping"].noul)

JavaScript 官方 SDK

使用 Node.js 20 或更新版本，在服务端运行，不要粘贴到浏览器控制台。先设置 TYPESAFE_API_KEY；将代码保存为 first-call.mjs，安装依赖后运行 node first-call.mjs。

npm install @typesafe-ai/sdk

import { choice, TypeSafeClient } from "@typesafe-ai/sdk";
const client = new TypeSafeClient();
const result = await client.systemOne({
  model: "jev-1.13.0",
  state: "客户希望查询尚未送达的包裹。",
  questions: { queue: choice("Which queue fits this request?", {
    shipping: "Delivery questions",
    other: "Anything else"
  }) }
});
console.log(result.answers.queue.choice);

验收与下一步

确认响应中有你的问题 ID、匹配的答案类型和合法数值。记录实际 model、用量和错误，不要写死示例概率。先验证一次调用，再加重试与队列分派。真实请求未在本次制作中运行；包内示例提供离线结构与路由测试。

配套示例：默认离线、不花 API 费用。启用 --live 前请阅读说明。下载示例代码 ZIP

先明确：哪里会产生费用

最小请求

Python 官方 SDK

JavaScript 官方 SDK

验收与下一步

本页来源与验证边界