快速开始

一、订阅套餐

登录 TokenPlan，选择适合你的套餐并完成 订阅 。个人版提供 Lite / Pro / Max 三档，订阅费 1:1 到账为可用额度，调用时按套餐折扣扣费。额度用完可随时增量充值。

二、创建 API Key

订阅后进入控制台 创建 API Key 并复制保存。API Key 用于鉴权和调用 TokenPlan 服务。

三、配置 API Key

推荐通过环境变量配置。

export YOUDAO_LLM_API_KEY="你的_API_Key"

$env:YOUDAO_LLM_API_KEY="你的_API_Key"

四、发起模型调用

OpenAI 兼容 API 地址为 https://openapi.youdao.com/llmgateway/api/v1。将 model 设为 auto，即可交给系统自动路由到合适的模型。 除了 auto，你也可以将 model 修改为具体 模型 ID ，例如 deepseek-flash（V4.1 flash）。可用模型 ID 请以控制台模型列表当前展示为准。

curl https://openapi.youdao.com/llmgateway/api/v1/chat/completions \
  -H "Authorization: Bearer $YOUDAO_LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下 TokenPlan。"
      }
    ]
  }'

调用成功后响应体中包含 choices 数组，回复内容在 choices[0].message.content。其中 model 是 Auto 实际命中的模型，cost 是本次消耗的额度。

五、Python 调用

如果项目使用 OpenAI Python SDK，只需替换 base_url。示例已包含在上方 Python 标签中。

六、流式输出

需要边生成边展示内容时，可以开启 stream。

stream = client.chat.completions.create(
    model="auto",
    messages=[
        {
            "role": "user",
            "content": "请介绍一下大模型 API 的应用场景。"
        }
    ],
    stream=True
)

for chunk in stream:
    if chunk.choices:
        content = chunk.choices[0].delta.content
        if content:
            print(content, end="", flush=True)

七、查看额度与用量

调用后，额度会按当前套餐折扣扣减。建议在控制台查看当前 当前套餐与折扣 、 剩余额度 和 调用明细 （按 Key 统计）。