Models and lanes
このコンテンツはまだ日本語訳がありません。
GET /models?contextLevel=&roleId= returns the catalog as groups → families → variants. A variant is one lane of that model: a stable codename with a price tier and live health. channelLabel is the only lane name that may reach a player.
How model lanes work
Section titled “How model lanes work”A model can use several upstream connections. Each lane has a public codename, pricing and availability information:
- a published codename remains associated with the same upstream;
- when an upstream degrades, traffic moves to another channel of the same lane and the player is told;
- prices and availability are listed by lane.
Lanes come in tiers: free (numbered, no vendor promise), economy (named lanes) and official (direct lanes). The tier is part of the catalog entry.
Choosing a lane
Section titled “Choosing a lane”The player’s choice is stored per card in player/role-settings (selectModel). The turn reads that setting. Do not cache the catalog for long; prices and health change.
Availability
Section titled “Availability”GET /models/uptime-history?model=&hours= returns recent availability for one lane. Show it next to the lane picker; it is the same data the console’s lane health view uses.
Failover
Section titled “Failover”If a request fails on the selected channel and the lane has another healthy channel, the server retries there and marks the turn with a lane-switch notice in messageMeta. Surface that notice; do not hide it. If every channel is down the turn fails with a retryable error.