文本与向量 - MaxAPI Developer

文本接口采用 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`

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

调用前确认

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

运行第一个聊天请求

查看 cURL、Python 和 JavaScript 完整示例。