主流大模型 API 快速上手

一、引言

AI 大模型时代，每个软件从业者都必须掌握的 API 技能

如果你从事软件开发、运维、测试、数据分析、产品经理——任何与软件相关的岗位——那么过去两年你一定频繁听到一个词：大语言模型（Large Language Model, LLM）。

从 ChatGPT 的横空出世，到 Claude 在代码理解上的突破，再到通义千问、Gemini、文心一言等国产模型的迅速崛起，AI 大模型已经从"前沿技术实验"变成了"行业标准工具"。它正在重塑我们构建软件的方式：

• 智能客服24/7 自动应答，大幅降低人工成本
• 代码助手自动补全、代码审查、Bug 修复
• 内容生成营销文案、技术文档、多语言翻译
• 数据分析自然语言查询数据库，自动生成报表
• 知识管理构建企业知识库，实现智能问答

而这一切的基础，都是API 调用。

为什么你必须学会调用大模型 API？

很多人会问："我用 ChatGPT 网页版不就行了吗？为什么要学 API？"

答案很简单：网页版是玩具，API 才是生产力工具。

• 网页版只能一对一聊天，API 可以嵌入你的产品
• 网页版无法批量处理，API 可以自动化流水线
• 网页版无法定制，API 可以调整参数、接入自有数据
• 网页版无法规模，API 可以支撑百万级用户

无论你是想在产品中集成 AI 能力，还是想用 API 自动化日常工作中的重复任务，掌握大模型 API 调用都是一项必备技能。

这篇文章能帮你做什么？

本文将手把手带你完成从注册到调用的完整流程，覆盖目前主流的五大大模型平台：

每个平台都会覆盖：注册流程、获取 API Key、Python/Node.js 调用示例、计费说明、速率限制。

准备好了吗？我们开始！

二、大模型 API 入门基础

在开始之前，你需要了解的核心概念

调用大模型 API 之前，有几个核心概念必须理解。它们是所有平台的通用语言，理解了这些，你才能高效使用任何大模型服务。

1. Token（词元）

Token 是大模型处理文本的基本单位。

大模型不是按"字"或"词"来处理文本的，而是按 Token。你可以粗略理解为：

• 英文：1 个 Token ≈ 0.75 个单词（约 4 个字符）
• 中文：1 个 Token ≈ 1 个汉字（不同模型有差异）

示例："Hello, world!"→ 约 3-4 个 Token
示例："今天天气很好"→ 约 6 个 Token

2. Context Window（上下文窗口）

Context Window 是模型一次能"记住"的最大文本量。

它包含了你发送的提示词（输入）加上模型生成的回复（输出）。常见模型的 Context Window：

3. Temperature（温度）

Temperature 控制生成内容的随机性和创造性。

• Temperature = 0：确定性最高，相同输入总是得到相同输出。适合：数据提取、分类、代码生成
• Temperature = 0.3-0.7：平衡创造性和准确性。适合：一般对话、文案撰写
• Temperature = 0.8-1.0：创造性最高，输出更随机。适合：创意写作、头脑风暴

4. Top-P（核采样）

Top-P 是另一种控制生成多样性的参数。

实用建议：通常只需要调整 Temperature，Top-P 保持 0.9 或 1.0 即可。两者不建议同时调整。

5. System Prompt（系统提示词）

System Prompt 是设定模型"角色"和"行为准则"的指令。

6. Stream（流式输出）

流式输出让模型逐字返回结果，而不是等全部生成完才返回。

API 调用的通用流程

1. 注册账号 → 2. 获取 API Key → 3. 安装 SDK → 4. 编写代码 → 5. 发起请求 → 6. 处理响应

三、OpenAI GPT 系列 API

全球最流行的 AI 模型 API

OpenAI 是第一个将大语言模型 API 商业化的公司。它的生态最成熟、文档最完善、社区最大。如果你只能学一个平台的 API，选 OpenAI 准没错。

1. 注册流程

步骤 1：访问 platform.openai.com

步骤 2：点击 "Sign Up"，支持 Google / Apple / Microsoft 账号登录或邮箱注册

步骤 3：验证邮箱地址

步骤 4：创建 API Key → Settings → API Keys → "Create new secret key"

⚠️ API Key 只在创建时显示一次，请务必立即保存！

2. Python 调用示例

# 安装：pip install openai import os from openai import OpenAI client = OpenAI(api_key=os.environ.get("OPENAI_API_KEY")) response = client.chat.completions.create( model="gpt-5.4-mini", messages=[ {"role": "system", "content": "你是一个有帮助的助手。"}, {"role": "user", "content": "用一句话解释什么是人工智能。"} ], temperature=0.7, max_tokens=100, ) print(response.choices[0].message.content)

3. Node.js 调用示例

// 安装：npm install openai import OpenAI from "openai"; const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY, }); async function main() { const response = await openai.chat.completions.create({ model: "gpt-5.4-mini", messages: [ { role: "system", content: "你是一个有帮助的助手。" }, { role: "user", content: "用一句话解释什么是人工智能。" } ], temperature: 0.7, max_tokens: 100, }); console.log(response.choices[0].message.content); } main().catch(console.error);

4. 计费说明

5. 速率限制

免费层（Tier 1）：GPT-5.4 mini 约 200 RPM / 40,000-200,000 TPM

付费层（Tier 2+）：500-5,000 RPM / 50,000-800,000 TPM

四、阿里通义千问（Qwen）API

中文能力最强的国产模型

阿里通义千问由阿里巴巴达摩院研发，是国内最早开放的大语言模型之一。它对国内用户非常友好——无需科学上网，注册简单，还有免费额度。

1. 注册流程

步骤 1：访问 dashscope.console.aliyun.com

步骤 2：使用阿里云账号登录（支持手机号注册）

步骤 3：完成实名认证

步骤 4：创建 API Key → "API-KEY 管理" → "创建新的 API-KEY"

2. Python 调用示例（OpenAI 兼容格式）

# 安装：pip install openai from openai import OpenAI client = OpenAI( api_key=os.environ.get("DASHSCOPE_API_KEY"), base_url="https://dashscope.aliyuncs.com/compatible-mode/v1", ) response = client.chat.completions.create( model="qwen-plus", messages=[{"role": "user", "content": "用一句话解释什么是人工智能。"}], temperature=0.7, )

3. 计费说明

五、Anthropic Claude API

代码理解和安全性的标杆

Claude 系列以出色的代码理解能力、安全对齐和长上下文处理能力著称。如果你需要处理复杂代码或文档，Claude 是首选。

1. 注册流程

步骤 1：访问 console.anthropic.com

步骤 2：使用 Google 账号或邮箱注册

步骤 3：创建 API Key → "API Keys" → "Create Key"

2. Python 调用示例

# 安装：pip install anthropic from anthropic import Anthropic client = Anthropic(api_key=os.environ.get("ANTHROPIC_API_KEY")) message = client.messages.create( model="claude-sonnet-4-20250514", max_tokens=1024, messages=[ {"role": "user", "content": "用一句话解释什么是人工智能。"} ], temperature=0.7, ) print(message.content[0].text)

3. 计费说明

六、Google Gemini API

免费额度最大的多模态王者

Google Gemini 以多模态能力和超长的 Context Window 著称。它的免费额度是几大平台中最大的，非常适合学习和原型开发。

1. 注册流程

步骤 1：访问 aistudio.google.com

步骤 2：使用 Google 账号一键登录

步骤 3："Get API Key" → "Create API Key in new project"

2. Python 调用示例

# 安装：pip install google-genai from google import genai client = genai.Client(api_key=os.environ.get("GEMINI_API_KEY")) response = client.models.generate_content( model="gemini-2.0-flash", contents="用一句话解释什么是人工智能。" ) print(response.text)

3. 计费说明

七、百度文心一言 API

国内生态完善的中文大模型

百度文心一言（ERNIE）由百度研发，在中文理解、知识问答等方面表现优异。通过百度智能云千帆平台提供服务。

1. 注册流程

步骤 1：访问 cloud.baidu.com

步骤 2：使用手机号注册百度账号

步骤 3：完成实名认证

步骤 4：进入千帆平台 → 创建应用 → 获取 API Key 和 Secret Key

2. Python 调用示例

# 安装：pip install requests import os import requests def get_access_token(): api_key = os.environ.get("BAIDU_API_KEY") secret_key = os.environ.get("BAIDU_SECRET_KEY") response = requests.post( "https://aip.baidubce.com/oauth/2.0/token", params={ "grant_type": "client_credentials", "client_id": api_key, "client_secret": secret_key, } ) return response.json().get("access_token") def call_ernie(prompt): access_token = get_access_token() url = f"https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions_pro?access_token={access_token}" response = requests.post(url, json={ "messages": [{"role": "user", "content": prompt}], "temperature": 0.7, }, headers={"Content-Type": "application/json"}) return response.json().get("result", "")

3. 计费说明

八、通用最佳实践

让你的 API 调用更稳定、更安全、更省钱

1. 错误处理与重试机制

指数退避重试策略（Python）

import time, random def chat_with_retry(client, messages, max_retries=3, base_delay=1.0): for attempt in range(max_retries): try: response = client.chat.completions.create( model="gpt-5.4-mini", messages=messages ) return response.choices[0].message.content except RateLimitError: if attempt == max_retries - 1: raise delay = (base_delay * (2 ** attempt)) + random.uniform(0, 1) time.sleep(delay)

2. API Key 安全管理

• 使用环境变量存储 API Key
• 使用 .env 文件 + .gitignore
• 生产环境使用密钥管理服务
• 定期轮换 API Key

3. 成本控制技巧

九、快速参考表

各平台核心数据一目了然

SDK 安装命令速查

# Python pip install openai # OpenAI pip install dashscope # 通义千问 pip install anthropic # Claude pip install google-genai # Gemini pip install requests # 文心一言 # Node.js npm install openai # OpenAI / 通义千问 npm install @anthropic-ai/sdk # Claude npm install @google/genai # Gemini npm install axios # 文心一言

十、总结

关键要点回顾

• 五大主流平台（OpenAI、通义千问、Claude、Gemini、文心一言）的完整注册和调用流程
• Python 和 Node.js 双语言调用示例，包含错误处理和流式输出
• 计费规则和速率限制，帮你控制成本避免踩坑
• 通用最佳实践，写出生产级的 API 调用代码

如何选择适合你的 API？

你的下一步

1. 选一个平台，注册账号，获取 API Key
2. 运行本文的代码示例，确保能跑通
3. 在你的项目中集成，从小功能开始尝试
4. 监控 Token 消耗，合理控制成本
5. 探索高级功能：Function Calling、多轮对话、向量嵌入

AI 大模型 API 已经是非常成熟的工具了。与其观望，不如动手试试。最好的学习方式，就是现在调用你的第一个 API。