AIHelms

AIHelms Docs

供应商类型与接入格式

创建供应商时选择正确的类型和接入格式。

创建供应商前，从上游控制台或接口文档确认以下信息：

  • 服务由哪家厂商或哪套推理服务提供。
  • API Base。
  • API Key。
  • 接口示例使用 /v1/chat/completions、/v1/responses 还是 /v1/messages。

选择供应商类型

在“模型纳管 > 供应商管理 > 新建”的“类型”下拉框中，按真实上游选择。列表中没有对应项时选“其他”。

实际上游选择类型常用接入格式
OpenAIOpenAIOpenAI
AnthropicAnthropicAnthropic
Azure OpenAIAzureOpenAI
Google GeminiGoogleOpenAI
DeepSeekDeepSeekOpenAI；上游提供 Messages 接口时也可选 Anthropic
AWS BedrockAWS BedrockOpenAI
Vertex AIVertex AIOpenAI
火山引擎火山引擎OpenAI；上游提供 Messages 接口时也可选 Anthropic
阿里云百炼百炼OpenAI；上游提供 Messages 接口时也可选 Anthropic
智谱智谱OpenAI；上游提供 Messages 接口时也可选 Anthropic
MoonshotMoonshotOpenAI；上游提供 Messages 接口时也可选 Anthropic
MiniMaxMiniMaxOpenAI；上游提供 Messages 接口时也可选 Anthropic
小米 MiMo小米 MiMo按上游开放的接口选择
vLLMvLLMOpenAI；服务端开放 Messages 接口时也可选 Anthropic
SGLangSGLangOpenAI
OllamaOllamaOllama
LM StudioLM StudioLM Studio
未列出的兼容服务其他OpenAI 或 Anthropic

不要因为模型名中有 Claude、GPT 或 DeepSeek，就改变供应商类型。例如，Bedrock 上的 Claude 仍然选择“AWS Bedrock”。

选择接入格式

接入格式看 API 请求协议，不看下游客户端。

上游接口特征选择格式
文档使用 OpenAI SDK，或路径为 /v1/chat/completions、/v1/responses、/v1/embeddingsOpenAI
文档使用 Anthropic SDK，或路径为 /v1/messagesAnthropic
上游服务是 LM StudioLM Studio
上游服务是 OllamaOllama

Claude Code 是下游客户端，不是判断上游格式的依据。上游只提供 OpenAI 兼容接口时，凭证必须选择 OpenAI。

填写示例

DeepSeek 官方 OpenAI 兼容接口可按下图填写：

DeepSeek 供应商类型与接入格式示例

名称：DeepSeek 生产
类型：DeepSeek
接入格式：OpenAI

如果同一供应商同时提供 OpenAI 和 Anthropic 两套接口：

  1. 在供应商上同时勾选 OpenAI 和 Anthropic。
  2. 分别创建两套凭证。
  3. 每套凭证填写对应的 API Base，并分别测试。
  4. 在模型下分别添加部署。

API Base 怎么填

API Base 填基础地址或版本根路径，不填具体业务接口。

地址是否可用
https://api.openai.com/v1可以
https://api.deepseek.com可以
https://gateway.example.com/v1按该网关文档确认
https://api.example.com/v1/chat/completions不可以，包含了具体接口
https://api.example.com/v1/messages不可以，包含了具体接口
https://console.example.com不可以，这是控制台网页

配置错误时的表现

现象先检查
保存凭证后测试返回 404接入格式是否选错；API Base 是否带了具体接口路径
返回协议或参数错误OpenAI 与 Anthropic 格式是否选反
自建服务连接超时AIHelms 所在服务器是否能访问该地址；不要填写只在本机有效的 127.0.0.1
Claude Code 找不到模型先确认 Anthropic 部署测试成功，再使用带 (Anthropic) 后缀的模型 ID

下一步：创建供应商和凭证。