Skip to content

模型提供商 ​

模型提供商(Provider)用于描述一个 AI 服务端点或厂商,协议适配器(Adapter)决定请求格式。CHAT 模型支持 OpenAI-compatible Chat Completions 和 OpenAI Responses,Embedding 使用 OpenAI-compatible,Rerank 使用 Qwen/HTTP Rerank。

当前支持状态 ​

Provider/能力状态说明
OpenAI-compatible Chat已支持通过 OpenAI 兼容协议创建 Chat 模型
OpenAI Responses Chat已支持通过 openai-responses 适配器调用 Responses API
OpenAI-compatible Embedding已支持通过 OpenAI 兼容协议创建 Embedding 模型
Qwen/HTTP Rerank已支持用于 RAG 检索结果重排序
CodeLink 中转站已支持内置 codelink Provider,支持 Chat Completions、Responses、Embedding 和 Rerank
自定义 Provider 元数据已支持可在管理后台维护名称、key、图标、启用状态
Claude / Gemini / Ollama / 火山引擎不作为当前源码内置一等 Provider 描述如服务兼容 OpenAI API,可按兼容端点方式验证接入

OpenAI-compatible Provider ​

大量模型服务支持 OpenAI API 兼容格式。接入时重点配置:

字段说明示例
提供商名称页面展示名DeepSeek
提供商标识唯一 keydeepseek
API Endpoint服务端点https://api.deepseek.com
Model Key模型标识deepseek-chat
模型类型能力类型CHAT

OpenAI Responses ​

Provider 元数据不绑定具体 CHAT 协议。同一 Provider 下可以分别创建 openai-compatible 和 openai-responses 模型配置:

字段示例说明
提供商标识openai仍使用现有 Provider 标识
API Endpointhttps://api.openai.com/v1Responses 服务根地址(包含 API 版本前缀)
Model Keygpt-5支持 Responses 的模型标识
模型类型CHATResponses 当前作为 CHAT 模型接入
适配器openai-responses使用 Responses 请求/响应格式

openai-compatible 仍是 CHAT 默认适配器。已有配置不会自动迁移,也不会在 Responses 调用失败后回退到 Chat Completions。

CodeLink 使用 OpenAI 兼容协议接入。新增或选择 Provider 时使用规范标识 codelink,模型配置如下:

字段示例说明
提供商名称CodeLink页面展示名
提供商标识codelink用于启用 CodeLink 内置配置和请求标识
API Endpointhttps://aicodelink.top/v1管理端自动使用该固定端点,不展示端点输入框
Model Keygpt-5实例中已配置的模型标识
适配器openai-compatible 或 openai-responses按模型实际支持的接口选择

使用 CodeLink 前,请先通过 CodeLink 专属邀请链接 注册并创建 API Key。管理端在选中 CodeLink 时会直接展示该注册提示。

调用 CodeLink 时,Snail AI 会在最终请求 URL 上追加 source=snail-ai。例如:

text
https://aicodelink.top/v1/responses?source=snail-ai

已有 query 参数会被保留;已有 source 会统一替换为 snail-ai,重复经过拦截器也只保留一个标识。规范 key codelink、现有数据别名 aicodelink 以及历史 key new-api 都会启用该标识,其他 OpenAI-compatible Provider 的请求 URL 不变。

新安装环境会通过 MySQL、PostgreSQL 或达梦初始化脚本创建 CodeLink Provider。已有环境可在管理后台手动新增,且无需修改数据库结构。

管理提供商 ​

查看提供商列表 ​

bash
curl -X GET 'http://localhost:8900/snail-ai/ai-model/providers' \
  -H 'Snail-Ai-Auth: <admin-token>'

新增提供商 ​

在管理后台进入「模型管理」,点击「新增提供商」,填写:

字段是否必填说明
提供商名称是页面显示名称
提供商标识是唯一 key,建议小写英文、数字和连字符
描述否备注信息
图标 URL否用于界面展示

providerKey 创建后不建议修改,并且必须保持全局唯一。

接入 DeepSeek 示例 ​

  1. 创建 Provider:
    • 名称:DeepSeek
    • 标识:deepseek
  2. 创建模型配置:
    • 模型类型:CHAT
    • API Endpoint:https://api.deepseek.com
    • Model Key:deepseek-chat
    • API Key:填写服务商密钥
  3. 在模型列表点击「验证」,确认端点、密钥和模型标识可用。
  4. 设置为默认 Chat 模型。
  5. 创建智能体并发起对话验证。

注意事项 ​

  • 不要仅因为文档中出现某个厂商名称,就默认它是源码内置 Provider。
  • 只有 Chat、Embedding、Rerank 是当前源码已落地的调用规格;CHAT 当前包含两个协议适配器。
  • 接入新的非兼容协议时,需要新增对应模型 Provider 实现,而不只是新增 Provider 元数据。
  • CodeLink 为第三方服务,使用前请确认模型来源、计费和数据处理政策。

相关源码 ​

  • snail-ai-server/snail-ai-server-admin/src/main/java/com/aizuda/snail/ai/admin/controller/AiModelController.java
  • snail-ai-models/snail-ai-model-chat/snail-ai-model-chat-provider-openai-compatible
  • snail-ai-models/snail-ai-model-chat/snail-ai-model-chat-provider-openai-responses
  • snail-ai-models/snail-ai-model-embedding/snail-ai-model-embedding-provider-openai-compatible
  • snail-ai-models/snail-ai-model-rerank/snail-ai-model-rerank-provider-qwen
  • snail-ai-models/snail-ai-model-common/src/main/java/com/aizuda/snail/ai/model/common/http/NewApiProviderRequestInterceptor.java

Apache 2.0 Licensed