Skip to main content
GET
/
api
/
v1
/
models
List Models
curl --request GET \
  --url https://api.example.com/api/v1/models
{
  "models": [
    {
      "mode": "<string>",
      "model_id": "<string>",
      "label": "<string>",
      "engine": "<string>",
      "description": "<string>"
    }
  ]
}
Returns the full registry of available Theo engines. Each model maps to a specific execution mode.

​
Authentication

Requires a Bearer token. See Authentication.

​
Request Examples

curl https://hitheo.ai/api/v1/models \
  -H "Authorization: Bearer $THEO_API_KEY"

​
Response

​
models
object[]
Array of available models.

​
Example Response

{
  "models": [
    {
      "mode": "fast",
      "model_id": "theo-1-flash",
      "label": "Theo Flash",
      "engine": "theo-core",
      "description": "Fast, lightweight completions for simple tasks"
    },
    {
      "mode": "think",
      "model_id": "theo-1-reason",
      "label": "Theo Reason",
      "engine": "theo-core",
      "description": "Deep reasoning and multi-step analysis"
    },
    {
      "mode": "code",
      "model_id": "theo-1-code",
      "label": "Theo Code",
      "engine": "theo-core",
      "description": "Production-quality code generation optimized for long-form output"
    },
    {
      "mode": "image",
      "model_id": "theo-1-create",
      "label": "Theo Create",
      "engine": "theo-vision",
      "description": "Photorealistic image generation"
    },
    {
      "mode": "research",
      "model_id": "theo-1-research",
      "label": "Theo Research",
      "engine": "theo-search",
      "description": "Multi-step web research with source synthesis"
    }
  ]
}
Use this endpoint to verify your API key is working — a successful response confirms authentication.