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

# 接入路线图

> 按你的场景选择最短路径

先判断你是哪一种使用场景，再进入对应文档。第一次接入不要从 API 参考开始，先按 [快速开始](/quickstart) 跑通一个最小请求。

Tapapi 的核心原则是：能走 OpenAI 兼容就先走兼容路径；需要更复杂的图片、工具或生产能力时，再进入对应专题。

<CardGroup cols={2}>
  <Card title="第一次跑通" icon="rocket" href="/quickstart">
    从注册、API Key 到第一个文本或图片请求，按三步走完。
  </Card>

  <Card title="接文本模型" icon="message-square" href="/text-generation/overview">
    聊天、摘要、改写、翻译、AI Coding 和自动化流程。
  </Card>

  <Card title="接图片模型" icon="image" href="/image-generation/overview">
    文生图、图片生成、批量出图和图片工作流。
  </Card>

  <Card title="已有 OpenAI SDK" icon="repeat" href="/integrations/openai-sdk">
    保留原来的 SDK，优先替换 `base_url`、`api_key` 和 `model`。
  </Card>

  <Card title="视频 API" icon="video" href="/video-generation/overview">
    受控开放，生产前先确认控制台模型、价格和账号权限。
  </Card>

  <Card title="不知道选哪个模型" icon="boxes" href="/models/choose-model">
    从模型清单看定位、价格、速度和适用场景。
  </Card>

  <Card title="准备上线" icon="shield-check" href="/production/launch-checklist">
    检查失败重试、限流、成本和文件保存。
  </Card>

  <Card title="接入工具" icon="plug" href="/integrations/dify">
    配置 Dify、Open WebUI、ComfyUI、n8n / Make 等常用工具。
  </Card>
</CardGroup>

## 推荐阅读顺序

<Steps>
  <Step title="先跑通最小请求">
    读 [快速开始](/quickstart)，先确认 API Key、base URL 和模型名可用。
  </Step>

  <Step title="确认调用路径">
    文本任务看 [文本 API](/text-generation/overview)；图片任务先看 [图片 API](/image-generation/overview)。已有 OpenAI SDK 项目优先走兼容路径。
  </Step>

  <Step title="选择模型">
    到 [模型中心](/models/choose-model) 选择更适合质量、速度或成本的模型。
  </Step>

  <Step title="上线前补齐失败处理">
    看 [错误码与重试](/errors)、[限流与并发](/production/rate-limits) 和 [上线 Checklist](/production/launch-checklist)，把余额不足、429、临时 5xx、504 / 524 的处理和告警补齐。
  </Step>
</Steps>

## 文档地图

| 你要解决的问题                         | 去哪里                                          |
| ------------------------------- | -------------------------------------------- |
| Tapapi 是什么，适合谁                  | [Tapapi 是什么](/introduction)                  |
| 复制代码跑通第一个请求                     | [快速开始](/quickstart)                          |
| API Key 放哪里，base URL 是什么        | [认证鉴权](/authentication)                      |
| 文本模型怎么接                         | [文本 API · 概览](/text-generation/overview)     |
| 图片模型怎么接                         | [图片生成 · 概览](/image-generation/overview)      |
| 已有 OpenAI SDK 怎么改               | [OpenAI SDK 迁移](/integrations/openai-sdk)    |
| 视频 API 当前状态                     | [视频 API · 受控开放](/video-generation/overview)  |
| 模型价格、速度、适用场景                    | [如何选择模型](/models/choose-model)               |
| 失败扣不扣、怎么退款                      | [计费与退款](/billing)                            |
| 线上报错怎么处理                        | [错误码与重试](/errors)                            |
| 生产上线前检查                         | [上线 Checklist](/production/launch-checklist) |
| Dify / Open WebUI / ComfyUI 怎么配 | [工具集成](/integrations/dify)                   |