GET STARTED
Find the right model.
Choose an available model and use its exact ID in your request.
Explore the catalog
Browse Models to compare providers, capabilities, context limits and token prices. A catalog entry alone does not mean the model can be called. Check its availability and supported endpoint on the model page.
Some models require streaming. Some support Responses only. Structured output and function calling depend on the model.
GET /v1/models
This authenticated endpoint lists enabled public model IDs. Use an exact ID from the list in the model field. The response does not include full capability or pricing metadata. Embedding models appear in this list but not in the public model catalog; their IDs and prices are in the Embeddings guide.
curl https://api.tokely.me/v1/models \
-H "Authorization: Bearer $TOKELY_API_KEY"Choose a routing mode
Account Settings offers Balanced, Lowest cost, Fastest, Most reliable and Fixed. For a new API request, X-Tokely-Routing can select balanced, lowest-cost, fastest, most-reliable or fixed.
Published prices apply to the normal route. When a selected or fallback supplier costs more, the charge rises to cover its verified procurement tariff without requiring an additional margin. The engine reserves the selected route charge before starting work; insufficient balance or an unknown supplier price prevents submission. Eligible native fallback routes are ordered by comparable estimated route cost. These estimates are not guaranteed supplier charges. Adaptive selection needs eligible routes and sufficient quotes or measurements. When those are unavailable, the receipt explains a fallback to Balanced. Lowest cost uses a normalized token mix; it is not a guarantee for every workload. A single-route model has no route fallback.
Context and output
The service accepts an explicit output limit up to the lower of the model’s published limit and 262,144 tokens. Models without an established output limit use a 4,096-token service cap.
The default output budget is 256 tokens, including reasoning. Increase it for longer answers and reasoning models, and ensure your balance covers the reservation.