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

# 文本与向量

> 聊天补全、文本补全和向量嵌入接口。

文本接口采用 OpenAI 兼容格式。已有 OpenAI SDK 项目通常只需修改 Base URL、API Key 和模型 ID。

## 推荐接口

| 场景        | 方法与路径                       | 主要响应字段                      |
| --------- | --------------------------- | --------------------------- |
| 多轮对话与工具调用 | `POST /v1/chat/completions` | `choices[].message`、`usage` |
| 传统文本补全    | `POST /v1/completions`      | `choices[].text`、`usage`    |
| 生成向量      | `POST /v1/embeddings`       | `data[].embedding`、`usage`  |

<Tip>
  新的对话应用优先使用聊天补全接口。只有现有客户端依赖纯文本提示词时才使用文本补全接口。
</Tip>

## 调用前确认

* 从控制台复制准确的模型 ID。
* OpenAI SDK 的 Base URL 使用 `https://api.maxapi.ai/v1`。
* 消息角色和多模态内容必须符合具体模型支持的格式。
* 流式响应需要在客户端逐块读取，不要等待完整 JSON。

<Card title="运行第一个聊天请求" icon="rocket" href="/quickstart">
  查看 cURL、Python 和 JavaScript 完整示例。
</Card>