跳到主要内容

DeepSeek

本指南将 AISIX AI 网关连接到 DeepSeek。调用方可以通过网关的 OpenAI 兼容 API 访问 DeepSeek V4 模型，凭证、模型允许列表、限流和用量核算由 AISIX 管理。

DeepSeek 提供 OpenAI 兼容 API，因此使用 openai 适配器并搭配 DeepSeek 的 api_base。

前提条件​

以下示例使用自托管 AISIX 网关。配置上游前，请准备以下内容：

配置 DeepSeek 上游​

为 DeepSeek 支持的 Chat Completions 路由创建服务提供方密钥、模型别名和调用方 API Key。

创建服务提供方密钥​

创建用于存储 DeepSeek 凭证和 API 根地址的服务提供方密钥：

# 请替换为实际值
export AISIX_ADMIN_KEY="YOUR_ADMIN_KEY"
export DEEPSEEK_API_KEY="YOUR_PROVIDER_API_KEY"

curl -sS -X POST "http://127.0.0.1:3001/admin/v1/provider_keys" \
  -H "Authorization: Bearer ${AISIX_ADMIN_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "deepseek-prod",
    "provider": "deepseek",
    "adapter": "openai",
    "secret": "'"${DEEPSEEK_API_KEY}"'",
    "api_base": "https://api.deepseek.com"
  }'

❶ provider 为 deepseek。

❷ adapter 为 openai，因为 DeepSeek 接受 OpenAI Chat Completions 请求。

❸ secret 存储 DeepSeek API Key，遵循服务提供方凭证中的凭证处理行为。

❹ api_base 必填。对于 openai 以外的任何服务提供方，AISIX 不会回退到 api.openai.com；如果 api_base 为空则报错。AISIX 会在 api_base 后追加端点路径，因此请使用厂商根地址 https://api.deepseek.com，不要带尾部的 /chat/completions。

复制返回的服务提供方密钥 ID。

创建模型​

创建调用方将在请求中发送的模型别名：

# 请替换为实际值
export PROVIDER_KEY_ID="YOUR_PROVIDER_KEY_ID"

curl -sS -X POST "http://127.0.0.1:3001/admin/v1/models" \
  -H "Authorization: Bearer ${AISIX_ADMIN_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "deepseek-v4-flash-prod",
    "provider": "deepseek",
    "model_name": "deepseek-v4-flash",
    "provider_key_id": "'"${PROVIDER_KEY_ID}"'"
  }'

❶ display_name 是调用方在 model 中发送的别名。

❷ model_name 是 DeepSeek 模型 ID，例如 deepseek-v4-flash 或 deepseek-v4-pro。

❸ provider_key_id 将别名关联到 DeepSeek 服务提供方密钥。

创建调用方 API Key​

选择应用发送给 AISIX 的调用方 API Key，然后为 Admin 资源计算哈希：

# 请替换为实际值
export AISIX_API_KEY="YOUR_CALLER_API_KEY"

CALLER_KEY_HASH=$(printf '%s' "${AISIX_API_KEY}" | shasum -a 256 | awk '{print $1}')

创建允许访问该模型别名的调用方 API Key 资源：

curl -sS -X POST "http://127.0.0.1:3001/admin/v1/apikeys" \
  -H "Authorization: Bearer ${AISIX_ADMIN_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "key_hash": "'"${CALLER_KEY_HASH}"'",
    "allowed_models": ["deepseek-v4-flash-prod"]
  }'

allowed_models 必须与你创建的模型别名匹配。

验证服务提供方连接​

通过 AISIX 代理发送 Chat Completions 请求：

curl -sS -X POST "http://127.0.0.1:3000/v1/chat/completions" \
  -H "Authorization: Bearer ${AISIX_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash-prod",
    "messages": [
      {
        "role": "user",
        "content": "Say hello from DeepSeek."
      }
    ]
  }'

网关会返回回显面向调用方别名 deepseek-v4-flash-prod 的 OpenAI 兼容响应。请在 DeepSeek 平台用量页面确认该请求。如果 AISIX 返回上游认证错误，请检查服务提供方密钥的 secret；如果返回上游路由错误，请检查 api_base 和 model_name 中的 DeepSeek 模型 ID。

思维模式​

DeepSeek V4 默认启用思维模式。如需禁用该模式，请在请求中使用以下参数：

{
  "thinking": {
    "type": "disabled"
  }
}

无论请求是否使用流式传输，AISIX 都会在响应的 reasoning_content 字段中保留服务提供方返回的推理内容。

下一步​

你现在已将 AISIX 连接到 DeepSeek，并验证了模型别名。接下来可继续阅读：