Models
Use model: "auto" to let JoyToken select the concrete model during routing, or send a modelName from the catalog to pin a specific model.
A modelName from the catalog can be sent as the request model to pin that model. See Routing for how a pinned model behaves.
Recommended Choice
Auto Routing
auto lets JoyToken choose a model within API key policy, tier, wallet balance, and model-pool availability.
List Models
Set JOY_TOKEN_API_BASE_URL from Environments before calling the model catalog.
Set locale=en for English descriptions or locale=zh for Chinese descriptions. If locale is omitted, the API defaults to English.
Common filter:
GET /api/v1/models is public. The metadata and pricing endpoints require an API key. Send either Authorization: Bearer $JOY_TOKEN_API_KEY or X-API-Key: $JOY_TOKEN_API_KEY.
Catalog Metadata
Use catalog metadata to build filters without hard-coding provider names or capability tags.
The response contains tiers, skus, featureTags, industryPacks, providers, and updatedAt.
Pricing
The response lists customer-facing tier exchange-rate descriptions. This endpoint requires an API key.
Model Fields
Model Is Listed But Request Fails
The model catalog shows the models available to JoyToken routing. Send model: "auto" to let JoyToken choose, or send a catalog modelName to pin one. Check:
