Docs/DevThrottle API/Models
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/models
List 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 model field.
Note
Requires a valid dt_ key like every endpoint - the list is your list, not a global catalog.