大模型 API Key 怎么获取和使用？新手完整指南

swancloud

217人浏览 · 2026-08-19 20:10:16

swancloud · 2026-08-19 20:10:16 发布

人工智能大模型（如通义千问、DeepSeek、智谱GLM、Kimi等）不仅能网页对话，还能通过 API 集成到自己的应用。调用 API 的前提是获取专属的 API Key，它相当于身份凭证，用于验证权限和计量用量。本指南教你获取、配置和使用 API Key，零基础也能上手。在这里插入图片描述

一、API Key 是什么？

API Key 是服务商生成的一串唯一标识符，通常形如 sk-xxx。请求时需放入请求头或参数中，服务端验证通过后返回模型结果。不同厂商的 Key 不能混用。

API Key 等同于密码，泄露后可能被他人盗用并产生费用，务必妥善保管。

二、如何获取 API Key？

核心路径：注册账号 → 开通服务/实名认证 → 进入 API Key 管理页面 → 创建 Key。下面以阿里云百炼为例，并附其他平台方式。

1. 阿里云百炼（通义千问）

提供千问系列模型，支持 OpenAI 兼容接口和 DashScope SDK，适合新手。

获取步骤：

注册/登录阿里云，进入百炼控制台，完成实名认证。
开通百炼服务，确认地域（如“华北2（北京）”）。
在控制台右上角切换地域，然后进入 API Key 管理页面。
单击 创建 API Key，填写描述（可选）后确认。
创建成功后弹窗显示完整 Key，立即复制保存，关闭后无法再看完整 Key。

说明：主账号可查看所有业务空间下的 API Key；子账号只能查看已加入业务的 Key。

2. 其他常见平台

服务商	获取方式	备注
DeepSeek	登录后点击“API keys”→ 创建	实名后可领免费 tokens
智谱AI（GLM）	开放平台 →“API keys”→ 创建	新用户可领体验 tokens
月之暗面（Kimi）	开放平台 →“API Key 管理”→ 新建	实名后可能赠送体验金
OpenRouter	头像 → Keys → Create Key	聚合多家模型的第三方平台
百度千帆（文心一言）	应用接入 → 创建应用，获取 API Key 与 Secret Key	需实名认证并开通服务
七牛云 AI 大模型推理	控制台 → AI 大模型推理 → API Key → 创建密钥	首次创建可激活免费额度

提示：赠送 tokens、价格和有效期可能调整，以官方最新页面为准。

三、配置 API Key 到环境变量

避免在代码中写死 Key，推荐配置为环境变量，安全且便于复用。

Windows 系统配置

搜索“编辑系统环境变量”并打开。
点击“环境变量”，在“系统变量”中点击“新建”。
变量名填 DASHSCOPE_API_KEY（可自定义），变量值粘贴 API Key。
确定保存，新开的终端生效。

验证：CMD 或 PowerShell 执行 echo %DASHSCOPE_API_KEY%。

Linux / macOS 系统配置

以 Linux 为例，编辑 ~/.bashrc：

nano ~/.bashrc

末尾追加：

export DASHSCOPE_API_KEY="你的API Key"

保存后执行：

source ~/.bashrc

验证：echo $DASHSCOPE_API_KEY。macOS 可将同样命令写入 ~/.zshrc（若用 zsh）。

四、使用 API Key 调用大模型

下面以阿里云百炼“通义千问”为例，展示三种常见方式。

方式一：使用 DashScope SDK（适合 Python）

安装 SDK：

pip install dashscope

创建 test_qwen.py：

import os
import dashscope
from dashscope import Generation

dashscope.api_key = os.getenv("DASHSCOPE_API_KEY")

response = Generation.call(
    model="qwen-turbo",
    messages=[
        {"role": "system", "content": "你是一个有用的助手"},
        {"role": "user", "content": "你好，请用一句话介绍自己。"}
    ]
)

print(response.output.text)

运行：python test_qwen.py。

方式二：使用 OpenAI 兼容接口（通用）

用 openai 库调用，只需修改 base_url 和 api_key。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url=""
)

completion = client.chat.completions.create(
    model="qwen-turbo",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

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

方式三：纯 HTTP 请求（任意语言）

直接用 HTTP POST 请求，Python requests 示例：

import os
import requests

API_KEY = os.getenv("DASHSCOPE_API_KEY")
url = ""

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

payload = {
    "model": "qwen-turbo",
    "messages": [
        {"role": "user", "content": "Classify the sentiment: The banana pudding was really tasty!"}
    ]
}

response = requests.post(url, json=payload, headers=headers, timeout=10)
print(response.json()["choices"][0]["message"]["content"])