模型

JoyToken 支持两种模型选择方式：model: "auto" 自动路由，或指定模型目录里的具体 model_key。

推荐选择

自动路由

1
{
2
  "model": "auto",
3
  "tier": "standard",
4
  "messages": [
5
    { "role": "user", "content": "Write a short onboarding message." }
6
  ]
7
}

auto 会在 API Key 策略、tier、钱包余额和模型池状态允许的范围内选择模型。

固定模型

1
{
2
  "model": "GLM-5",
3
  "messages": [
4
    { "role": "user", "content": "Write a concise release note." }
5
  ]
6
}

固定模型适合已完成评测的生产链路。它仍然会经过 API Key 策略、黑名单、tier 和钱包检查。

获取模型目录

调用模型目录前，先从 环境 选择并设置 JOY_TOKEN_API_BASE_URL。

$
curl "$JOY_TOKEN_API_BASE_URL/api/v1/models"

常用筛选：

$
curl "$JOY_TOKEN_API_BASE_URL/api/v1/models?tier=standard&feature_tag=code"

模型字段

模型列表能看到但请求失败

模型目录是平台可用模型，不代表每把 API Key 都能调用。失败时检查：