模型 | JoyToken | Documentation

JoyToken 模型请求只接受 model: "auto"，具体模型由 JoyToken 在路由过程中选择。

模型目录返回的模型标识仅用于查看信息，不能作为请求的 model。Chat Completions、Responses、图片生成和 Anthropic Messages 请求都必须使用 "auto"。

自动路由

{
  "model": "auto",
  "tier": "standard",
  "messages": [
    { "role": "user", "content": "Write a short onboarding message." }
  ]
}

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

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

curl "$JOY_TOKEN_API_BASE_URL/api/v1/models?locale=zh"

locale=zh 返回中文描述，locale=en 返回英文描述；不传 locale 时默认返回英文。

常用筛选：

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

GET /api/v1/models 是公开接口。元数据和价格接口需要 API Key，可发送 Authorization: Bearer $JOY_TOKEN_API_KEY 或 X-API-Key: $JOY_TOKEN_API_KEY。

用目录元数据构建筛选器，不需要在应用里写死提供商名称或能力标签。

curl "$JOY_TOKEN_API_BASE_URL/api/v1/models/meta" \
  -H "Authorization: Bearer $JOY_TOKEN_API_KEY"

响应包含 tiers、skus、featureTags、industryPacks、providers 和 updatedAt。

curl "$JOY_TOKEN_API_BASE_URL/api/v1/pricing" \
  -H "X-API-Key: $JOY_TOKEN_API_KEY"

响应列出面向客户的档位兑换价格的说明。此接口必须提供 API Key。

字段	含义
`modelId` / `modelKey`	当前响应始终为 `auto`；请求模型必须使用 `model: "auto"`
`displayName` / `alias`	当前响应始终为 `auto`
`tier`	计费和路由档位
`tags`	商品标签
`description`	由 `locale` 选择语言的模型说明
`provider`	当前响应始终为 `auto`
`featureTags`	能力标签
`scenarioTags`	场景标签
`mciScore`	目录评分
`customerInputMtok`	输入价格，单位 Cr / MTok
`customerOutputMtok`	输出价格，单位 Cr / MTok
`customerCachereadMtok`	缓存读取价格，单位 Cr / MTok
`customerCachewriteMtok`	缓存写入价格，单位 Cr / MTok
`customerImageInputMtok`	图片输入价格，decimal string；不可用时为空字符串
`customerImageCachedInputMtok`	图片缓存输入价格，decimal string；不可用时为空字符串
`customerImageOutputMtok`	图片输出价格，decimal string；不可用时为空字符串

模型目录展示 JoyToken 路由可使用的模型，应用仍然必须发送 model: "auto"。失败时检查：