> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 列出模型

> 列出所有可用的 Theo 引擎模型及其能力。

返回可用 Theo 引擎的完整注册表。每个模型都对应一种特定的执行模式。

## 身份验证

需要提供 Bearer 令牌。参见[身份验证](/api-reference/authentication)。

## 请求示例

<CodeGroup>
  ```bash curl theme={null}
  curl https://www.hitheo.ai/api/v1/models \
    -H "Authorization: Bearer $THEO_API_KEY"
  ```

  ```typescript SDK theme={null}
  const models = await theo.models();

  for (const m of models) {
    console.log(`${m.label} (${m.model_id}) — ${m.description}`);
  }
  ```
</CodeGroup>

## 响应

<ResponseField name="models" type="object[]">
  可用模型数组。

  <Expandable title="模型对象">
    <ResponseField name="mode" type="string">该模型对应的执行模式（例如 `"fast"`、`"think"`、`"code"`）。</ResponseField>
    <ResponseField name="model_id" type="string">Theo 品牌模型 ID（例如 `"theo-1-flash"`）。</ResponseField>
    <ResponseField name="label" type="string">易读的名称（例如 `"Theo Flash"`）。</ResponseField>
    <ResponseField name="engine" type="string">引擎子系统（例如 `"theo-core"`）。</ResponseField>
    <ResponseField name="description" type="string">该模型最擅长的任务。</ResponseField>
  </Expandable>
</ResponseField>

### 响应示例

```json theme={null}
{
  "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"
    }
  ]
}
```

<Tip>
  使用此端点可验证你的 API 密钥是否有效——成功的响应即表示身份验证通过。
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.