模型
使用 model: "auto" 时由 JoyToken 在路由过程中选择具体模型;也可以传入模型目录中的 modelName,把请求固定到指定模型。
模型目录中的 modelName 可以作为请求的 model 传入,用于指定模型。指定模型的行为请参考 路由。
推荐选择
自动路由
auto 会在 API Key 策略、tier、钱包余额和模型池状态允许的范围内选择模型。
获取模型目录
调用模型目录前,先从 环境 选择并设置 JOY_TOKEN_API_BASE_URL。
locale=zh 返回中文描述,locale=en 返回英文描述;不传 locale 时默认返回英文。
常用筛选:
GET /api/v1/models 是公开接口。元数据和价格接口需要 API Key,可发送 Authorization: Bearer $JOY_TOKEN_API_KEY 或 X-API-Key: $JOY_TOKEN_API_KEY。
目录筛选元数据
用目录元数据构建筛选器,不需要在应用里写死提供商名称或能力标签。
响应包含 tiers、skus、featureTags、industryPacks、providers 和 updatedAt。
价格详情
响应列出面向客户的档位兑换价格的说明。此接口必须提供 API Key。
模型字段
模型列表能看到但请求失败
模型目录展示 JoyToken 路由可使用的模型。发送 model: "auto" 由 JoyToken 选择,或传入目录中的 modelName 指定模型。失败时检查:
