大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



---

本文是AI应用开发的核心实战课，针对零基础新手，详细拆解3个主流大模型（OpenAI GPT、百度文心一言、阿里通义千问）的API注册流程、密钥获取方法，并提供可直接复制运行的Python代码（含逐行解释）。同时整理了新手最易踩的5类错误及解决方案，覆盖国内/海外模型选择、网络问题、代码调试等核心痛点，确保零基础也能100%跑通。

---

零基础也能跑通！手把手教你获取API密钥，写出第一行AI调用代码

---

《从提示词到智能体：30天成为AI应用开发新手》专栏，专为零基础人群打造！全程拒绝晦涩理论，聚焦实战操作，每天1小时，带你从“AI使用者”变身“AI开发者”。上一篇我们搞懂了提示词和智能体，这一篇直接动手：注册大模型API、获取密钥、用Python发起第一次AI请求，真正迈出AI开发第一步！

---

本文是AI应用开发的核心实战课，针对零基础新手，详细拆解3个主流大模型（OpenAI GPT、百度文心一言、阿里通义千问）的API注册流程、密钥获取方法，并提供可直接复制运行的Python代码（含逐行解释）。同时整理了新手最易踩的5类错误及解决方案，覆盖国内/海外模型选择、网络问题、代码调试等核心痛点，确保零基础也能100%跑通。

大模型API；OpenAI注册；文心一言API；Python调用AI；API密钥；AI开发实战；零基础AI

---

上一篇我们知道了：提示词是指挥AI的“指令”，而调用大模型API是实现AI应用的“必经之路”。

但很多新手卡在第一步：

• 不知道选哪个大模型API？
• 注册时要翻墙吗？需要实名认证吗？
• 密钥怎么获取？怕泄露怎么办？
• 代码怎么写？运行报错怎么解决？

这篇文章，我会用最细致的文字步骤+可复制代码，帮你解决所有问题——无论你在国内还是海外，无论你选OpenAI还是国产模型，跟着做，10分钟就能让AI给你回复！

---

新手不用纠结“哪个最好”，先根据自己的情况选择：是否能翻墙、是否需要中文优化、预算多少。下面是3个最适合新手的API对比，信息100%真实可查：

新手选择建议（避坑指南）：

1. 优先选国内模型（文心一言/通义千问）：注册快、无翻墙需求、中文适配好，免费额度足够学习（练1个月都用不完）；
2. 想体验GPT-4：备好科学上网工具+可接收国际短信的手机号（国内手机号也能试，部分用户成功），免费额度够新手练手；
3. 预算为0：直接选文心一言，免费额度最多，调用门槛最低。

---

2.1 OpenAI注册+密钥获取（含避坑技巧）

准备工具：

• 科学上网工具（需稳定连接海外节点）；
• 邮箱（推荐Gmail/Outlook，国内邮箱也可尝试）；
• 国内手机号（+86）或海外手机号。

注册步骤（每一步都标清按钮位置）：

1. 访问官网：打开浏览器，输入 https://platform.openai.com，右上角点击 “Sign up”（注册）；
2. 邮箱注册：
   • 输入邮箱 → 点击 “Continue” → 收到验证邮件（查垃圾邮件）→ 点击邮件中的验证链接；
   • 设置密码（8位以上，必须包含大小写字母+数字，例如AiDev123!）；
3. 手机号验证（关键步骤）：
   • 验证邮箱后，跳转到“Phone number verification”页面；
   • 国家选择“China (+86)”，输入你的手机号 → 点击 “Send code”；
   • 等待短信验证码（可能延迟3-5分钟，耐心等，别频繁点击）；
   • 输入6位验证码 → 验证通过（若收不到，可换节点或尝试海外手机号接码平台，注意合规性）；
4. 创建组织（可选）：
   • 跳转后问“Create an organization?”，点击 “Skip”（跳过），后续可在设置中创建；
5. 获取API密钥（核心步骤）：
   • 登录后，右上角点击你的头像 → 下拉菜单选择 “View API keys”；
   • 页面中间点击 “Create new secret key” → 输入密钥名称（例如“my-first-ai-key”）→ 点击 “Create secret key”；
   • 弹出密钥（形如 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）→ 立即复制并保存到记事本（密钥只显示1次，刷新页面就没了！）；
6. 查看免费额度：
   • 右上角头像 → 点击 “Billing” → 左侧“Overview”可查看剩余免费额度（新用户一般\(5-\)18）。

避坑技巧：

• 密钥保存：复制后存到“记事本+云文档”，避免丢失；
• 免费额度有效期：3个月，过期后需充值（支持支付宝，最低充值$5）；
• 验证失败：换科学上网节点（推荐美国/新加坡节点），或换个浏览器重试。

2.2 百度文心一言注册+密钥获取（10分钟搞定）

准备工具：

• 国内手机号；
• 身份证号（实名认证用）。

注册步骤：

1. 访问百度智能云：输入 https://console.bce.baidu.com/ → 右上角点击 “注册”（已有百度账号直接登录）；
2. 实名认证（必须步骤）：
   • 登录后，控制台首页顶部提示“未实名认证” → 点击 “去认证”；
   • 选择“个人认证” → 输入姓名+身份证号 → 选择“支付宝验证”（扫码1秒完成）；
   • 认证成功后，页面显示“已实名”；
3. 开通文心一言服务：
   • 控制台顶部搜索框输入“文心一言” → 点击搜索结果中的 “文心一言ERNIE-Bot”；
   • 进入产品页后，点击 “立即开通” → 勾选“同意服务条款” → 点击 “开通服务”（无费用，免费开通）；
4. 创建应用+获取密钥：
   • 开通后自动跳转到“应用管理”页面 → 点击 “创建应用”；
   • 填写信息：应用名称（例如“AI开发学习”）、应用类型选“AI应用”、其他字段默认 → 点击 “创建”；
   • 应用创建成功后，点击 “查看详情” → 找到 “API Key” 和 “Secret Key” → 复制保存（两个都要，后续调用需要）。

关键提醒：

• 文心一言的密钥是“API Key + Secret Key”组合，不是单个密钥；
• 免费额度：新用户默认送100万token，在“资源管理”→“配额管理”中查看。

2.3 阿里通义千问注册+密钥获取

准备工具：

• 国内手机号；
• 身份证号（实名认证用）。

注册步骤：

1. 访问阿里云官网：输入 https://www.aliyun.com/ → 右上角 “免费注册”（已有账号直接登录）；
2. 实名认证：
   • 登录后，点击右上角“控制台” → 顶部提示“未完成实名认证” → 点击 “去认证”；
   • 选择“个人认证” → 输入姓名+身份证号 → 支付宝扫码验证 → 认证成功；
3. 开通通义千问服务：
   • 控制台顶部搜索“通义千问” → 点击 “通义千问大模型”；
   • 进入产品页后，点击 “立即开通” → 同意服务协议 → 开通成功；
4. 获取AccessKey：
   • 控制台右上角点击你的头像 → 选择 “AccessKey管理”；
   • 点击 “创建AccessKey” → 验证手机短信（输入验证码）；
   • 生成 “AccessKey ID” 和 “AccessKey Secret” → 复制保存（Secret只显示1次，务必保存）。

---

核心逻辑：向大模型API发送“提示词”请求，接收AI返回的结果。我们分“curl快速测试”和“Python代码封装”两步，新手先试curl，再写Python。

3.1 用curl命令快速测试（无需写代码，验证API可用）

打开终端（Mac/Linux）或命令提示符（Windows），复制对应命令，替换密钥即可。

示例1：测试OpenAI API（GPT-3.5）

GPT plus 代充 只需 145curl https://api.openai.com/v1/chat/completions  -H “Content-Type: application/json”  -H “Authorization: Bearer sk-你的OpenAI密钥”  -d ‘{

"model": "gpt-3.5-turbo", "messages": [{"role": "user", "content": "你好，我是AI开发新手，能跟我打个招呼吗？"}] 

}’

示例2：测试文心一言API

GPT plus 代充 只需 145# 第一步：先获取Access Token（替换API Key和Secret Key） curl “https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=你的API Key&client_secret=你的Secret Key”

# 第二步：用Access Token调用生成接口（替换xxx为上一步获取的token） curl “https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ernie_speed?access_token=xxx"; -H ”Content-Type: application/json“ -d ‘{

"messages": [{"role": "user", "content": "你好，我是AI开发新手，能跟我打个招呼吗？"}] 

}’

成功标志：

终端返回JSON数据，其中choices[0].message.content（OpenAI）或result（文心一言）字段是AI的回复，说明API可用！

3.2 Python代码实战（可直接运行，含详细注释）

3.2.1 调用OpenAI（GPT-3.5）

第一步：安装依赖库

打开终端，执行命令：

GPT plus 代充 只需 145pip install openai # 安装OpenAI官方Python库 

第二步：完整代码（openai_chat.py）

# 1. 导入OpenAI库 import openai # 2. 配置API密钥（建议用环境变量，避免硬编码泄露） # 方式1：直接赋值（新手测试用，正式开发禁用） openai.api_key = ”sk-你的OpenAI密钥“

# 方式2：从环境变量读取（推荐！安全无泄露） # import os # openai.api_key = os.getenv(”OPENAI_API_KEY“) # 需先设置环境变量

# 3. 定义聊天函数（封装调用逻辑） def chat_with_gpt(prompt, model=”gpt-3.5-turbo“):

GPT plus 代充 只需 145try: # 发送API请求 response = openai.ChatCompletion.create( model=model, # 模型名称（固定gpt-3.5-turbo） messages=[ # 对话历史：role可选user（用户）、assistant（AI）、system（系统提示） {"role": "user", "content": prompt} ], temperature=0.7, # 创造性：0（严谨）~1（活泼），新手默认0.7 max_tokens=200, # 最大回复长度：200token足够简短对话 timeout=10 # 超时时间：10秒（避免网络卡顿时无限等待） ) # 提取AI回复（从JSON结果中解析） ai_reply = response.choices[0].message.content.strip() return ai_reply except Exception as e: # 捕获错误（新手必加，避免程序崩溃） return f"调用失败：{str(e)}" 

# 4. 主程序（用户交互） if name == ”main“:

print("===== AI聊天助手（OpenAI GPT-3.5）=====") while True: # 接收用户输入 user_input = input("你：") # 退出条件 if user_input in ["退出", "quit", "q"]: print("AI：再见！祝你学习顺利～") break # 调用AI并打印结果 result = chat_with_gpt(user_input) print(f"AI：{result} 

”)

第三步：运行代码

终端执行：

GPT plus 代充 只需 145python openai_chat.py 

输入“你好，介绍一下自己”，即可看到AI回复！

3.2.2 调用百度文心一言（新手首选）

第一步：安装依赖库

pip install requests # 用于发送HTTP请求 

第二步：完整代码（wenxin_chat.py）

GPT plus 代充 只需 145# 1. 导入必要库 import requests import json

# 2. 配置你的密钥（从百度智能云应用详情页获取） API_KEY = “你的文心一言API Key” SECRET_KEY = “你的文心一言Secret Key”

# 3. 第一步：获取Access Token（有效期30天，建议缓存，不用每次请求） def get_access_token():

url = "https://aip.baidubce.com/oauth/2.0/token" params = { "grant_type": "client_credentials", "client_id": API_KEY, "client_secret": SECRET_KEY } # 发送请求获取token response = requests.post(url, params=params, timeout=5) if response.status_code == 200: return response.json().get("access_token") else: raise Exception(f"获取Token失败：{response.text}") 

# 4. 第二步：调用文心一言API def chat_with_wenxin(prompt):

GPT plus 代充 只需 145# 获取token access_token = get_access_token() # API调用地址 url = f"https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ernie_speed?access_token={access_token}" # 请求参数（文心一言的格式要求） payload = json.dumps({ "messages": [{"role": "user", "content": prompt}], "temperature": 0.7, "max_output_tokens": 200 # 最大回复长度 }) # 请求头 headers = {"Content-Type": "application/json"} # 发送POST请求 response = requests.post(url, headers=headers, data=payload, timeout=10) if response.status_code == 200: # 提取AI回复（文心一言的回复在result字段） return response.json().get("result").strip() else: return f"调用失败：{response.text}" 

# 5. 主程序（用户交互） if name == “main”:

print("===== AI聊天助手（百度文心一言）=====") while True: user_input = input("你：") if user_input in ["退出", "quit", "q"]: print("AI：再见！祝你学习顺利～") break result = chat_with_wenxin(user_input) print(f"AI：{result} 

“)

第三步：运行代码

替换API_KEY和SECRET_KEY后，执行：

GPT plus 代充 只需 145python wenxin_chat.py 

输入问题，即可收到文心一言的回复，全程无需翻墙！

3.3 安全提示（新手必看）

1. 禁止硬编码密钥：正式开发时，用环境变量或配置文件存储密钥（例如os.getenv(”API_KEY“)）；
2. 密钥不要分享：不要把密钥上传到GitHub、朋友圈等公共平台，泄露后可能被恶意调用产生费用；
3. 国内模型密钥有效期：文心一言/通义千问的密钥长期有效，无需频繁更换。

---

4.1 错误1：AuthenticationError / 401 Unauthorized（认证失败）

原因：密钥无效、过期，或未开通对应服务。
解决方案：

• 检查密钥是否复制完整（OpenAI密钥开头是sk-，文心一言是API Key+Secret Key组合）；
• 文心一言/通义千问：确认已开通对应服务（在“应用管理”中查看状态为“已开通”）；
• OpenAI：密钥是否泄露后被禁用？重新创建新密钥试试。

4.2 错误2：RateLimitError / 429 Too Many Requests（请求过快/额度不足）

原因：请求频率超过限制，或免费额度已用完。
解决方案：

• 降低请求频率：在代码中加入time.sleep(1)（每次请求间隔1秒）；
• 查看额度：OpenAI在“Billing”页面，文心一言在“配额管理”页面；
• 免费额度用完：国内模型可等待下月重置，或充值最低额度（文心一言最低1元）。

4.3 错误3：ConnectionError / 超时（连接失败）

原因：网络不通，或需要代理。
解决方案：

• OpenAI：检查科学上网工具是否开启，节点是否稳定（换美国/新加坡节点）；
• 国内模型：关闭VPN，直接用国内网络（国内模型不需要代理）；
• 代码中增加超时参数（如timeout=10），避免无限等待。

4.4 错误4：InvalidRequestError / 400 Bad Request（请求格式错误）

原因：模型名称错误、参数格式不对。
解决方案：

• 模型名称：OpenAI必须是gpt-3.5-turbo（不是gpt-3.5），文心一言是ernie_speed（不是ernie）；
• messages格式：必须是列表，每个元素包含role和content（缺一不可）；
• 检查JSON格式：Python中用json.dumps()处理请求体，避免语法错误。

4.5 错误5：Python库安装失败（pip报错）

原因：网络超时，或pip源未配置。
解决方案：

• 换国内pip源（加速安装）：

  pip install openai -i https://pypi.tuna.tsinghua.edu.cn/simple 

• 升级pip：

  GPT plus 代充 只需 145python -m pip install –upgrade pip 

---

今日任务：

1. 注册一个你选择的大模型API，获取密钥；
2. 复制本文的Python代码，替换密钥后运行成功；
3. 试着修改提示词（比如“用Python写一个Hello World程序”），观察AI的回复。

互动环节：

• 成功运行的同学，欢迎在评论区晒出你的AI回复截图！
• 遇到问题的同学，直接留言错误信息（例如“401错误+文心一言”），我会逐一帮你解决！

下一篇预告：第3篇《Python环境搭建与API请求封装》

• 教你安装Python+Anaconda，创建独立虚拟环境（避免依赖冲突）；
• 安全管理API密钥（环境变量+配置文件）；
• 封装可复用的API调用模块，支持多轮对话；
• 实现一个简单的“AI聊天机器人”（带历史对话记忆）。

现在，你已经成功调用了大模型API，这是AI应用开发的核心基础！下一篇我们将优化开发环境，为后续的智能体开发打牢基础～

原创不易，觉得有用欢迎 点赞+收藏+关注，后续30天实战内容持续更新，不错过每一节干货！

---

下篇见，一起解锁更多AI开发技能！