> ## 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？

> AI 编排 API——一次调用，覆盖所有模型，贯通完整流水线。

Theo 是一个以开发者 API 形式提供的 **AI 编排引擎**。你无需分别调用各家模型提供商，也无需自建分类、路由、工具执行和计费基础设施，只需调用 `POST /api/v1/completions`，剩下的一切都由 Theo 处理。

## Theo 能做什么

当你向 Theo 发送一个提示词时，一个多阶段流水线会自动运行：

1. **意图分类** —— 判断该提示词属于哪类任务（代码、研究、图像等）
2. **技能加载** —— 加载领域专业知识包（已安装的以及按请求指定的），注入系统提示词扩展和工具定义
3. **模型路由** —— 为该任务选择最优的 Theo 引擎，并自动进行故障转移
4. **智能体循环** —— 迭代式地进行推理、调用工具，并将结果反馈回去，直到任务完成
5. **响应** —— 返回格式化内容，包含引擎信息、工具执行日志、生成物、后续建议以及用量数据

这一切都在一次 API 调用中完成。

## 核心能力

<CardGroup cols={2}>
  <Card title="创建补全" icon="message-circle" href="/api-reference/completions/create">
    多模型 AI 补全，具备自动意图分类与路由能力。
  </Card>

  <Card title="什么是技能？" icon="puzzle" href="/skills/overview">
    可安装的领域知识与工具包——就像是 AI 的应用程序。
  </Card>

  <Card title="E.V.I." icon="bot" href="/guides/build-an-evi">
    以自定义角色将 Theo 嵌入你的产品。用户看到的是你的品牌，而不是 Theo。
  </Card>

  <Card title="生成代码" icon="code" href="/api-reference/code/generate">
    Theo Code 引擎，拥有更大的输出预算，用于生成长篇、业界领先的代码。
  </Card>

  <Card title="生成图像" icon="image" href="/api-reference/images/generate">
    Theo Create 引擎，生成照片级真实感图像，并具备自动回退能力。
  </Card>

  <Card title="创建研究任务" icon="search" href="/api-reference/research/create">
    深度网络研究，具备信息源综合与引用能力。
  </Card>

  <Card title="生成文档" icon="file" href="/api-reference/documents/generate">
    生成 PDF、DOCX、PPTX、XLSX 和 CSV 文件。
  </Card>

  <Card title="创建工作流" icon="workflow" href="/api-reference/workflows/create">
    多步骤自动化工作流，支持定时调度、事件触发和条件逻辑。
  </Card>
</CardGroup>

## 架构一览

```
Your App → @hitheo/sdk → Theo API (api.hitheo.ai)
                              │
                    ┌─────────┼─────────┐
                    ▼         ▼         ▼
              Classifier  Skill     Model
                          Loader    Router
                              │
                              ▼
                         Agent Loop
                    (think → act → observe)
                              │
                              ▼
                    Response + Billing + Audit
```

## 适用人群

* **产品开发者** —— 通过 SDK 或 REST API 将 AI 嵌入自己的应用
* **代理机构和 SaaS 公司** —— 为客户打造带品牌的 AI 助手（E.V.I.）
* **技能作者** —— 在市场上创建并变现特定领域的 AI 能力

## 快速上手

<Steps>
  <Step title="获取 API 密钥">
    在 [api.hitheo.ai](https://api.hitheo.ai) 注册，并在控制台中创建一个密钥。密钥以 `theo_sk_` 为前缀。
  </Step>

  <Step title="发起你的第一次调用">
    ```bash theme={null}
    curl -X POST https://www.hitheo.ai/api/v1/completions \
      -H "Authorization: Bearer theo_sk_..." \
      -H "Content-Type: application/json" \
      -d '{"prompt": "Explain quantum computing in one paragraph", "mode": "auto"}'
    ```
  </Step>

  <Step title="安装 SDK">
    ```bash theme={null}
    npm install @hitheo/sdk
    ```
  </Step>
</Steps>


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