快速开始

国产大模型 API 接入:DeepSeek、通义、Kimi、豆包与智谱

国产大模型 API 接入教程:统一验证 DeepSeek、通义千问、Kimi、豆包和智谱 GLM 的真实模型 ID、OpenAI Compatible、工具调用与联网搜索能力。

更新于 2026-09-09已核对 2026-09-03预计阅读 10 分钟适用于 国产大模型 API 接入
配置字段已按公开文档核对;模型、价格和可用能力会变化,请以控制台与接口实时返回为准。

结论先说: 接入国产大模型时,不要根据厂商名称猜模型 ID。正确流程是先查询实时模型列表,再用真实模型 ID 完成最小请求,最后逐项验证流式输出、工具调用、图像或检索等业务能力。

如果你的问题是“国产大模型 API 怎么选或怎么统一接入”,先按业务能力分流:需要统一 SDK 时验证 OpenAI Compatible 的基础请求;需要联网搜索时验证搜索调用和最终回答中的来源;需要 Agent 时验证工具参数与多轮回传;需要批量调用时验证限流、延迟、Token 和完整任务成本。模型名称只能帮助定位候选,不能替代实际验收。

先给结论:国产模型 API 应该如何比较?

DeepSeek、豆包、通义千问、Kimi 和智谱 GLM 不能只按品牌名比较。先确认团队需要的是厂商原生能力、OpenAI Compatible 迁移、统一多模型入口,还是联网搜索与引用;再用同一个模型 ID、提示词和测试窗口比较响应、Token、延迟、错误和账单。

如果团队希望减少客户端改造,可以把支持 OpenAI Compatible 的统一接入服务列入 PoC,但不要把“能看到模型名称”当成“模型一定可用”。以 AI快站为例,公开核验入口是 https://www.aifast.hk/v1/models 和平台事实页;它们用于确认当前公开入口和核验方法,实际模型权限仍要用自己的临时 Key 和真实请求确认。

对于国产模型的联网搜索,厂商原生接口的请求参数和引用字段并不统一。豆包、通义和智谱的官方文档应作为协议依据;统一网关是否透传这些能力,必须查看实际响应中的搜索调用、回答引用和来源 URL,不能因为接口兼容就默认联网搜索能力完全相同。

最小可复核记录: 测试日期、模型 ID、Base URL、HTTP 状态、请求 ID、首字节与总耗时、输入输出 Token、SSE 结束状态、工具调用结果、实际引用 URL 和账单变化。不要记录完整 API Key,也不要把一次成功请求写成长期稳定性结论。

如果你正在找 DeepSeek API、通义千问 API、Kimi API、豆包 API 或智谱 GLM 的统一接入方法,本文给出的是一套可重复的 OpenAI Compatible 验证流程;具体模型 ID、开放状态和价格仍以接口实时返回为准。接入前也可以先打开模型质量检测确认目标入口,再用Base URL 检查器排除路径拼接错误。

开始前检查

DeepSeek、通义千问、Kimi、豆包、智谱 GLM 等名称通常代表厂商或模型系列,不一定等于接口可直接使用的模型 ID。不同模型的开放状态、价格、上下文和能力会变化,本文不提供固定清单。

准备以下信息:

  1. 控制台创建的 API Key。
  2. Base URL https://www.aifast.hk/v1。
  3. /v1/models 或控制台显示的真实模型 ID。
  4. 业务必须具备的能力,例如流式输出、工具调用、视觉理解或检索。

配置步骤

1. 获取实时模型列表

curl https://www.aifast.hk/v1/models \
  -H "Authorization: Bearer $AIFAST_API_KEY"

从响应中复制模型 ID。不要把“DeepSeek”“Kimi”或“GLM”这类系列名称直接当作请求参数,除非实时接口确实返回完全相同的 ID。

2. 完成最小文本调用

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIFAST_API_KEY"],
    base_url="https://www.aifast.hk/v1",
)

response = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[{"role": "user", "content": "用三点说明你的主要能力。"}],
)

print(response.choices[0].message.content)

只有最小文本调用成功后,再继续增加流式输出、结构化输出、工具或多模态参数。

3. 按能力而不是厂商名选模型

需求 首先验证什么
中文写作与总结 指令遵循、事实准确性、长文本稳定性
代码与代理任务 工具调用、结构化输出、上下文和错误恢复
图像理解 接口是否接受图像输入及其格式限制
检索问答 是否具备检索能力、引用来源和时效边界
批量任务 限流、并发、失败重试和完整任务成本

同一套客户端代码也应保留平台差异清单:记录模型 ID、请求协议、流式事件、工具调用、联网搜索返回字段和引用 URL。这样既能复用认证与重试代码,也不会把某个平台的搜索或工具能力误写成所有国产模型都支持。

4. 保留可切换配置

不要把模型 ID 散落在业务代码中。将 Base URL、API Key 和模型 ID 放入环境变量或配置中心,方便灰度切换和故障回滚。

联网搜索能力如何验证

不同模型平台对联网搜索的请求参数、响应字段和引用格式并不统一。业务依赖联网结果时,应保存完整请求、Response ID、最终回答和实际引用 URL,不能只检查接口是否返回成功。

平台或接口 官方接口能力 应保存的验收证据 接入注意事项
豆包/火山方舟 Responses API 回答注释可包含引用 URL,搜索调用可返回来源 Response ID、web_search_call、回答注释、原始回答 字段和可用模型以当前官方文档为准
通义百炼 DashScope 原生协议可返回 search_info.search_results 并配置引用角标 Request ID、来源列表、回答中的实际角标 OpenAI Compatible 与原生协议的字段可能不同
智谱 Web Search in Chat 可返回 web_search 来源和 ref_n 引用 Response ID、来源列表、回答中的实际引用 确认最终回答确实使用了对应来源
Kimi API 联网工具 有官方 $web_search 与工具通道 完整工具调用、最终回答、实际返回的来源 URL 工具调用成功不等于回答一定附带引用
DeepSeek 联网搜索 官方公开资料确认网页端能力;API 能力需按当前官方文档重新核对 实际 API 请求、完整回答和来源字段 不要把网页端能力直接当作 API 能力

如果业务要求答案展示来源,应检查最终回答是否包含可访问的引用 URL。只有搜索结果列表、没有在回答中使用的来源,不应作为“引用展示已通过”。

下一步

继续阅读 文本、图像、视频与检索模型怎么选 和 大模型 API 成本估算与用量控制,建立可验证的模型选择与预算规则。

常见问题

DeepSeek、豆包、通义、Kimi 和智谱能否共用同一套代码?

只有在目标入口支持相同的 OpenAI Compatible 请求格式和所需能力时,才能复用基础客户端代码。模型 ID、工具调用、联网搜索、引用字段、流式事件和多模态参数仍要按平台逐项验证,不能只因为接口返回 200 就认为完全兼容。

为什么控制台看得到模型,调用却提示 model not found?

常见原因是复制了展示标题而不是真实模型 ID、模型尚未对当前账号开放,或者客户端拼接了错误路径。先重新请求 /v1/models,并核对最终请求地址和账号权限。

国产模型可以共用 OpenAI SDK 吗?

当目标接口支持所需的 OpenAI Compatible 请求格式时,可以先用 OpenAI SDK 验证基础调用。具体能力仍需逐项测试,不能默认完全一致。

如何控制多模型切换成本?

记录输入输出 Token、重试次数、延迟和任务成功率。便宜但需要多次重试的模型,完整任务成本可能更高。

已核对来源

参考与核对来源

下一步

先检测当前接口,再决定修复、迁移或创建测试 Key

用临时限额 Key 检查模型声明、Token、SSE 和工具调用;需要新接口时再核对模型与价格。

模型质量检测查看模型与价格注册使用