[智能体-8]：如何获取国内各大大模型的Key

国内大模型（通义千问、DeepSeek 等）大多做了OpenAI 兼容接口，可以直接用openaiSDK，只改api_key、base_url、model三个参数即可。下面给你可直接跑的完整示例。

一、公共准备（通用）

安装官方 SDK（无需装其他包）：

bash

运行

pip install -U openai python-dotenv

新建.env存密钥（不要硬写在代码里）：

env

# 通义千问 QWEN_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx QWEN_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1 # DeepSeek DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx DEEPSEEK_BASE_URL=https://api.deepseek.com

二、调用通义千问（Qwen）

1）基础调用

python

运行

import os from dotenv import load_dotenv from openai import OpenAI load_dotenv() client = OpenAI( api_key=os.getenv("QWEN_API_KEY"), base_url=os.getenv("QWEN_BASE_URL") ) resp = client.chat.completions.create( model="qwen-max", # 可选：qwen-plus、qwen-turbo、qwen3-max 等 messages=[ {"role": "system", "content": "你是 helpful 助手"}, {"role": "user", "content": "简要介绍 ROS2"} ], temperature=0.7, max_tokens=1024 ) print(resp.choices[0].message.content)

2）流式输出（逐字返回）

python

运行

stream = client.chat.completions.create( model="qwen-plus", messages=[{"role": "user", "content": "写一段快速排序 Python 代码"}], stream=True ) for chunk in stream: if chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True) print()

三、调用 DeepSeek

1）基础调用

python

运行

import os from dotenv import load_dotenv from openai import OpenAI load_dotenv() client = OpenAI( api_key=os.getenv("DEEPSEEK_API_KEY"), base_url=os.getenv("DEEPSEEK_BASE_URL") ) resp = client.chat.completions.create( model="deepseek-chat", # 或 deepseek-reasoner（思考模式） messages=[ {"role": "system", "content": "你是专业技术顾问"}, {"role": "user", "content": "解释一下大模型的 SFT 与 RLHF"} ], temperature=0.7 ) print(resp.choices[0].message.content)

2）流式输出

python

运行

stream = client.chat.completions.create( model="deepseek-chat", messages=[{"role": "user", "content": "用 5 句话总结深度学习"}], stream=True ) for chunk in stream: if chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True) print()

四、关键参数对照表（一眼看懂）

表格

五、常见坑 & 解决

1. 401 鉴权失败

   • 检查 api_key 是否正确、是否带sk-前缀
   • 确认该 key 已开通对应模型权限

2. 404 路径不存在

   • 千问：必须带/compatible-mode/v1
   • DeepSeek：/v1可加可不加，官方示例用根域名

3. 超时 / 网络慢

   • 千问优先用国内dashscope.aliyuncs.com
   • DeepSeek 国内访问不稳时可考虑合规中转

4. 模型名报错

   • 千问：不要写gpt-3.5，必须写qwen-xxx
   • DeepSeek：用deepseek-chat/deepseek-reasoner

六、多模型统一切换模板（推荐）

python

运行

def get_client(provider: str) -> OpenAI: load_dotenv() if provider == "qwen": return OpenAI(api_key=os.getenv("QWEN_API_KEY"), base_url=os.getenv("QWEN_BASE_URL")) elif provider == "deepseek": return OpenAI(api_key=os.getenv("DEEPSEEK_API_KEY"), base_url=os.getenv("DEEPSEEK_BASE_URL")) else: raise ValueError("unsupported provider") # 切换只需改这里 client = get_client("qwen") # 或 "deepseek"