快速开始

国产大模型 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.link/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.link/v1
  3. /v1/models 或控制台显示的真实模型 ID。
  4. 业务必须具备的能力,例如流式输出、工具调用、视觉理解或检索。

配置步骤

1. 获取实时模型列表

curl https://www.aifast.link/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.link/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 和工具调用;需要新接口时再核对模型与价格。

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