大模型 API 注册与调用实战：OpenAI、文心一言与通义千问

成功标志：返回 JSON 格式数据，包含 choices 字段。

Python 代码实战

1. 调用 OpenAI

第一步：安装依赖库

pip install openai

第二步：完整代码 (openai_chat.py)

import os
from openai import OpenAI

# 初始化客户端
client = OpenAI(api_key="YOUR_OPENAI_API_KEY")

response = client.chat.completions.create(
    model="gpt-3.5-turbo",
    messages=[{"role": "user", "content": "请用一句话介绍人工智能"}]
)

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

第三步：运行代码 确保环境变量或代码中填入正确的 Key，直接运行即可看到输出。

2. 调用百度文心一言

第一步：安装依赖库

pip install requests

第二步：完整代码 (wenxin_chat.py)

import requests
import json

access_token_url = 'https://aip.baidubce.com/oauth/2.0/token'
params = {
    'grant_type': 'client_credentials',
    'client_id': 'YOUR_API_KEY',
    'client_secret': 'YOUR_SECRET_KEY'
}

response = requests.post(access_token_url, params=params)
token = response.json().get('access_token')

chat_url = 'https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/eb-instant'
headers = {'Content-Type': 'application/json'}
payload = {
    'messages': [{'role': 'user', 'content': '请用一句话介绍人工智能'}]
}

result = requests.post(chat_url, headers=headers, json=payload, params={'access_token': token})
print(json.dumps(result.json(), ensure_ascii=False))

第三步：运行代码 替换 Key 后执行脚本，控制台将打印对话结果。

安全提示

• 永远不要将 API Key 硬编码在提交到 Git 的代码中。
• 建议使用环境变量存储敏感信息。
• 定期轮换密钥，发现泄露立即禁用。

新手常见错误及解决方案

1. 认证失败 (401 Unauthorized)

现象：报错 AuthenticationError 或 HTTP 401。 原因：Key 无效、过期或权限不足。 解决：检查 Key 是否复制完整，确认账户余额充足。

2. 请求过快 (429 Too Many Requests)

现象：报错 RateLimitError。 原因：触发频率限制。 解决：添加重试机制或使用指数退避策略，降低请求频率。

3. 连接超时

现象：ConnectionError 或长时间无响应。 原因：网络波动或防火墙拦截。 解决：检查网络环境，确认目标域名未被屏蔽。

4. 请求格式错误 (400 Bad Request)

现象：报错 InvalidRequestError。 原因：JSON 结构不符合 API 定义。 解决：对照官方文档核对 messages 或 payload 字段格式。

5. 库安装失败

现象：pip 报错。 原因：网络源问题或版本冲突。 解决：更换镜像源（如 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple ...）。

动手实践

今天的任务已完成：注册了至少一个平台，并成功调用了第一次 API 请求。建议保存好你的 Key，并在后续项目中封装成工具类以便复用。