Walmind API 开发者文档

欢迎使用 Walmind API 平台。这里集中说明如何通过标准 API 调用模型服务。

从哪里开始

目标	推荐阅读
第一次接触大模型 API	入门知识
第一次调用模型	快速开始
了解鉴权方式	认证与 API Key
了解接口分类和请求参数	接口格式与分类与 Chat Completions 格式
处理失败请求	错误处理

请使用以下 API 地址访问模型接口：

export API_BASE_URL="https://www.walmind.cn/v1"
export API_KEY="sk-your-api-key"

所有示例都可以直接复制后替换环境变量使用。文档站不保存 API Key，也不提供在线请求功能。

本文档只介绍普通用户调用模型所需的接口，包括模型列表、对话、向量、图片和音频接口。管理后台、用户管理和渠道配置属于平台内部能力，不在此文档中展示。

OpenAI 兼容接口的 Base URL 是 https://www.walmind.cn/v1。SDK 配置 Base URL 时不要重复拼接 /v1；Gemini 原生接口请参考对应页面的 /v1beta 路径。

使用 API Key 调用 GET /v1/models。返回结果只代表当前 Key、权限、渠道状态和余额下可用的模型，不能用文档中的示例模型名代替实时结果。

API Key 应保存在服务端环境变量或密钥管理系统中，通过 Authorization: Bearer <API_KEY> 发送。不要把真实 Key 写入浏览器前端、公开代码仓库或日志。

先查看 HTTP 状态码和 JSON 错误体，再参照错误处理：401 通常与 Key 有关，403 与权限有关，404 与路径或模型 ID 有关，429 与限流或余额有关，5xx 通常需要退避重试并联系支持团队。