API
Models
2 min read
The models endpoint tells you exactly what your key can call. Treat it as the source of truth: the list is account-dependent, and a model you cannot see here will be rejected by chat completions.
GET
/modelsList the models available to the caller. OpenAI list shape:
{ "object": "list", "data": [ { "id": ... }, ... ] }.Example
curl https://devthrottle.com/api/v1/models \
-H "Authorization: Bearer $DEVTHROTTLE_API_KEY"Transcription models
The default response lists chat-capable models. Pass ?type=transcription to get the transcription capability (a single fixed Whisper-large-v3 class model - see transcription for why the model parameter there is forgiving).
Practical advice
- Fetch the list at startup rather than hard-coding ids - availability can change, and unknown models are hard errors by design (no silent substitution, ever).
- Model ids are public names; use them as-is in the
modelfield.
Note
Requires a valid
dt_ key like every endpoint - the list is your list, not a global catalog.