接口格式与分类
华明平台将模型接口按“模型能力”和“请求格式”分层组织。同一项能力可能同时提供 OpenAI、Claude 或 Gemini 等协议入口，客户端必须选择与请求体、鉴权方式相匹配的页面。页面标题中的英文名称保留为协议或 SDK 的正式名称，正文提供对应的中文解释。
分类概览
| 分类 | 格式或接口 | 路径 | 适用场景 |
|---|---|---|---|
| 模型列表 | OpenAI 原生格式 | /v1/models | 查询当前 API Key 可用的模型 |
| 模型列表 | Gemini 原生格式 | /v1beta/models | 以 Gemini 字段结构返回模型列表 |
| 对话 / OpenAI | Chat Completions 格式 | /v1/chat/completions | 使用 messages 进行多轮对话、工具调用和流式输出 |
| 对话 / OpenAI | Responses 格式 | /v1/responses | 使用 input、instructions 和统一响应对象 |
| 对话 / Claude | Claude 原生格式 | /v1/messages | 使用 Anthropic Messages API 直接调用 Claude 模型 |
| 对话 / Gemini | Gemini 原生格式 | /v1beta/models/{model}:generateContent | Gemini 文本对话和多模态输入 |
| 补全 | OpenAI 原生格式 | /v1/completions | 兼容传统文本补全接口，使用 prompt |
| 向量嵌入 | OpenAI 原生格式 | /v1/embeddings | 生成文本向量，用于搜索、匹配和 RAG |
| 向量嵌入 | Gemini 原生格式 | /v1/engines/{model}/embeddings | 按 Gemini 兼容路径生成向量 |
| 重排序 | Rerank 格式 | /v1/rerank | 按查询相关性重新排列候选文档 |
| 内容审核 | OpenAI 原生格式 | /v1/moderations | 检测输入内容是否触发安全策略 |
| 音频 / OpenAI | 文本转语音 | /v1/audio/speech | 将文本转换为音频二进制流 |
| 音频 / OpenAI | 音频转写 | /v1/audio/transcriptions | 将音频转换为原语言文本 |
| 音频 / OpenAI | 音频翻译 | /v1/audio/translations | 将音频内容翻译为英文文本 |
| 音频 / Gemini | Gemini 原生格式 | /v1beta/models/{model}:generateContent | 使用 Gemini TTS 模型生成语音 |
| 实时语音 | OpenAI 原生格式 | GET /v1/realtime（WebSocket） | 建立双向实时音频会话 |
| 图像 / OpenAI | 图像生成、编辑 | /v1/images/generations、/v1/images/edits | 根据提示词生成或编辑图像 |
| 图像 / Gemini | Gemini 原生格式 | /v1beta/models/{model}:generateContent | 使用 Gemini 图像生成能力 |
| 视频 | 视频生成与任务查询 | /v1/video/generations | 创建异步视频生成任务并查询结果 |
这里的“OpenAI”“Claude”“Gemini”表示接口协议分组，不是模型名称；“原生格式”表示请求字段和响应结构遵循对应厂商的公开协议。平台是否开放某个路径，还取决于模型、渠道、分组权限和部署版本。
如何选择
- 先在模型列表中确认模型 ID、协议和能力。
- 使用 OpenAI SDK 的
chat.completions时，选择 Chat Completions 格式。 - 使用 OpenAI Responses SDK 或需要
input/output结构时，选择 Responses 格式。 - 使用 Anthropic SDK 时，选择 Claude 原生格式；使用 Gemini SDK 或 Gemini 原生请求体时，选择 Gemini 原生格式。
- 只有客户端明确要求传统
completions接口时，才选择 OpenAI 原生格式（Completions）。
即使请求格式正确，模型不支持该能力、参数或上下文长度时仍可能返回错误。遇到这种情况，请先用最小请求验证，再按模型能力逐项增加参数。文件、微调等 NewAPI 中标记为“未实现”的接口不在本平台公开 API 范围内，文档不会把占位接口写成可用能力。
公共配置
所有格式都使用相同的 Base URL 和 Bearer Token：
Base URL: https://www.walmind.cn/v1
Authorization: Bearer sk-your-api-key
model 必须填写模型列表接口返回的模型 ID，不要直接猜测上游厂商的模型名称。Gemini 原生接口使用 /v1beta/models 返回的模型名时，还要确认请求路径和鉴权方式与该协议一致。