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