> ## 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 · 概览

> 用 OpenAI 兼容方式接入文本模型

文本 API 用于聊天、问答、摘要、改写、翻译、分类、代码辅助和自动化流程。已有 OpenAI SDK 或 OpenAI-compatible 工具的项目，通常只需要替换 `base_url`、`api_key` 和 `model`。

文本模型默认走：

```text theme={null}
POST https://tapapi.ai/v1/chat/completions
```

这是文本 API 的入门主线。部分模型或场景也可能支持 Responses、Claude Messages 等其他协议入口，是否可用以控制台和模型详情为准。

<Note>示例默认使用 `gpt-5.4`。如果控制台推荐模型不同，以控制台为准。</Note>
<Warning>不同协议的响应结构不同。`/v1/chat/completions` 通常读取 `choices[0].message.content`，`/v1/responses` 不要复用同一个解析逻辑。</Warning>

## 你要做什么

| 场景               | 推荐入口                                                  |
| ---------------- | ----------------------------------------------------- |
| 聊天、问答、多轮对话       | [Chat Completions](/text-generation/chat-completions) |
| 网页聊天逐字输出         | [流式输出](/text-generation/streaming)                    |
| 已有 OpenAI SDK 项目 | [OpenAI 兼容](/text-generation/openai-compatible)       |
| 选择模型和参数          | [模型与参数](/text-generation/models-and-parameters)       |
| 组织提示词和上下文        | [Prompt 与上下文](/text-generation/prompting-context)     |
| 函数调用、JSON、外部工具   | [工具调用](/text-generation/tool-calling)                 |

## 最小请求

```bash theme={null}
curl https://tapapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "用一句话解释 Tapapi 是什么"}
    ]
  }'
```

文本返回通常读取：

```text theme={null}
choices[0].message.content
```

生产环境还要保存响应头 `X-Oneapi-Request-Id`、HTTP 状态码、`error.code`、模型名和耗时。排查超时、扣费、限流或上游异常时，这些字段比单纯保存回答内容更重要。

## 和其他板块的关系

| 你还需要                            | 去哪里                                  |
| ------------------------------- | ------------------------------------ |
| API Key 和安全边界                   | [认证鉴权](/authentication)              |
| 图片生成                            | [图片 API](/image-generation/overview) |
| 模型选择                            | [模型中心](/models/choose-model)         |
| Responses / Claude Messages 等协议 | 以模型详情和工具集成页为准                        |
| Python / Node.js / PHP 等语言示例    | [工具集成](/integrations/openai-sdk)     |
| 上线稳定性                           | [上线指南](/production/launch-checklist) |