# Walmind API 开发者文档

> Walmind（华明）模型 API 的中文开发者文档。文档说明如何通过统一入口调用 OpenAI 兼容、Claude 和 Gemini 协议，以及对话、向量、图像、音频、实时语音和视频能力。

## 先看这些页面

- [开发者文档首页](https://www.walmind.cn/docs/)
- [入门知识](https://www.walmind.cn/docs/getting-started/basics)：理解 Base URL、协议、模型和鉴权
- [快速开始](https://www.walmind.cn/docs/getting-started/quickstart)：使用 curl 完成第一次调用
- [认证与 API Key](https://www.walmind.cn/docs/getting-started/authentication)：服务端 Bearer Token 使用规则
- [接口格式与分类](https://www.walmind.cn/docs/api)：按能力、协议和 HTTP 路径查找接口
- [模型列表](https://www.walmind.cn/docs/api/models)：查询当前 API Key 可用模型
- [错误处理](https://www.walmind.cn/docs/getting-started/errors)：按 HTTP 状态码排查失败请求

## 常用接口

- [Chat Completions](https://www.walmind.cn/docs/api/chat-completions)：`POST /v1/chat/completions`
- [Responses](https://www.walmind.cn/docs/api/responses)：`POST /v1/responses`
- [Claude Messages](https://www.walmind.cn/docs/api/chat-claude)：`POST /v1/messages`
- [Gemini GenerateContent](https://www.walmind.cn/docs/api/chat-gemini)：`POST /v1beta/models/{model}:generateContent`
- [Embeddings](https://www.walmind.cn/docs/api/embeddings)：`POST /v1/embeddings`
- [图像生成](https://www.walmind.cn/docs/api/images)：`POST /v1/images/generations`
- [音频转写](https://www.walmind.cn/docs/api/audio)：`POST /v1/audio/transcriptions`
- [文本转语音](https://www.walmind.cn/docs/api/audio-speech)：`POST /v1/audio/speech`
- [实时语音](https://www.walmind.cn/docs/api/realtime)：`wss://www.walmind.cn/v1/realtime`

## 关键事实

- OpenAI 兼容接口的 Base URL 是 `https://www.walmind.cn/v1`。
- 示例中的 API Key 使用环境变量；不要将真实 Key 写入浏览器、代码仓库或日志。
- 模型是否可用取决于 API Key 权限、渠道状态、余额和实际部署，不应根据文档示例推断可用模型。
- 文档站不保存 API Key，也不提供在线请求功能。
- 数据安全、算力部署与服务时延说明见[平台说明](https://www.walmind.cn/docs/security)。

## 完整内容索引

需要读取全部页面摘要和接口索引时，请参阅 [llms-full.txt](https://www.walmind.cn/llms-full.txt)。