Rance的AI新手教程

Rance的AI新手教程06：API的调用方法及平台推荐

上一篇我们讲了API、Token、Temperature这些核心概念，今天就进入实战环节：如何真正调用API？

很多人觉得API很神秘，其实只要掌握了几个关键要素，调用API就像网购一样简单。这一篇会手把手教你。

调用API的三个核心要素

不管你用什么工具、什么平台，调用AI的API都离不开这三样东西：

1. API Key（密钥）

API Key = 你的身份证

就像你去银行取钱需要银行卡密码，调用API需要API Key来证明"这是我，可以给我服务"。

API Key长什么样？

通常是一串很长的字母+数字组合，比如：

sk-proj-abc123def456ghi789jkl012mno345pqr678stu901vwx234

重要提醒：

  • API Key是私密的，不要泄露给别人
  • 别人拿到你的Key，就能用你的账户调用API（花你的钱）
  • 如果不小心泄露了，立刻去平台删除旧Key，生成新的

2. Base URL（接口地址）

Base URL = 餐厅的地址

你点外卖要知道餐厅在哪，调用API要知道服务器在哪。

常见的Base URL：

  • OpenAI：https://api.openai.com/v1
  • Anthropic Claude：https://api.anthropic.com/v1
  • Google Gemini：https://generativelanguage.googleapis.com/v1
  • DeepSeek：https://api.deepseek.com/v1

第三方平台的URL会不一样，但格式类似。

3. Model Name（模型名称）

Model Name = 你要点的菜

你去餐厅要说"我要红烧肉"，调用API要说"我要用GPT-5.2"。

常见的Model Name：

  • OpenAI：gpt-5.2、gpt-5.2-chat-latest
  • Claude：claude-opus-4.5、claude-sonnet-4.5
  • Gemini：gemini-3-pro、gemini-3-flash
  • DeepSeek：deepseek-chat、deepseek-coder

一个完整的API调用示例

把这三样东西组合起来，一个最简单的API调用就是这样：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

import openai

# 1. 设置API Key
openai.api_key = "sk-proj-你的密钥"

# 2. 设置Base URL（如果用第三方平台）
openai.base_url = "https://api.openai.com/v1"

# 3. 调用指定的模型
response = openai.chat.completions.create(
    model="gpt-5.2",  # Model Name
    messages=[
        {"role": "user", "content": "你好"}
    ]
)

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

看起来很复杂？ 别担心，后面介绍的平台都有更简单的方法。

官方API vs 第三方平台

在介绍具体平台之前，先搞清楚一个重要概念：官方API和第三方平台有什么区别？

官方API

官方API = 直接从OpenAI、Anthropic、Google买

优点：

  • 稳定性最好，直连官方服务器
  • 功能最全，新功能第一时间支持
  • 安全性最高，数据不经过第三方

缺点：

  • 需要国外信用卡
  • 需要梯子访问（ChatGPT、Claude、Gemini）
  • 价格相对较高
  • 注册可能有门槛

第三方平台

第三方平台 = 从代理商买

第三方平台会先从官方买API额度，然后转卖给你。

优点：

  • 支持国内支付（支付宝、微信、银联）
  • 不需要梯子
  • 通常有中文界面和客服
  • 一个平台可以调用多家AI（OpenAI、Claude、Gemini等）
  • 有些平台有免费额度

缺点：

  • 稳定性可能不如官方
  • 价格可能比官方贵一点（但有些反而更便宜）
  • 安全性需要信任平台
  • 功能更新可能慢于官方

我该选哪个？

选官方，如果你：

  • 有国外信用卡
  • 有稳定的梯子
  • 重视数据安全
  • 需要最新功能

选第三方，如果你：

  • 没有国外支付方式
  • 没有梯子
  • 想用国内支付
  • 想一个平台调用多个AI

第三部分：平台推荐（2国内+2国外）

下面介绍四个我推荐的API平台，两个国内、两个国外，覆盖不同需求。

1. DeepSeek官方（国内，官方平台）

网址： https://platform.deepseek.com

平台类型： 官方平台

为什么推荐？

  • 官方平台，稳定可靠
  • DeepSeek V3.2性能接近GPT-5
  • 国内访问快，不需要梯子
  • 注册简单，手机号就能搞定
  • 价格极低，性价比超高

获取API Key步骤：

  1. 打开 https://platform.deepseek.com
  2. 点击右上角"登录/注册"
  3. 用手机号注册账号
  4. 登录后，点击左侧"API Keys"
  5. 点击"创建API密钥"
  6. 复制密钥（只显示一次，记得保存）PixPin_2026-01-30_11-02-52
  7. 点击左边接口文档查看url和模型名称 PixPin_2026-01-30_11-04-02 PixPin_2026-01-30_11-04-45|916x455 调用参数：
  • Base URL：https://api.deepseek.com
  • Model Name：deepseek-chat（对话）、deepseek-reasoner（推理）
  • API Key：你刚才复制的密钥

2. 火山引擎（国内，官方平台+第三方）

网址： https://console.volcengine.com/ark

平台类型： 官方平台（字节跳动旗下）

为什么推荐？

  • 字节跳动官方平台，稳定可靠
  • 支持豆包系列模型
  • 支持国内支付（支付宝、微信、银联）
  • 价格便宜，性价比高
  • 除了豆包自家模型，还可以调用很多国内开源模型，如DeepSeekV3.2、GLM4.7

使用步骤：

  1. 打开 https://console.volcengine.com/ark
  2. 用手机号注册火山引擎账号
  3. 进入"方舟大模型"控制台
  4. 完成实名认证（需要身份证）
  5. 点击"APIKey管理"PixPin_2026-01-30_11-07-49
  6. 创建新的API密钥
  7. 复制密钥并保存
  8. 点击左边开通管理，选择你要用的模型PixPin_2026-01-30_11-08-37
  9. 在新页面复制你要的模型名称（注意，同一个模型在不同平台名字不一样，所以要具体查看）PixPin_2026-01-30_11-09-25
  10. 回到开通管理页面，注意状态是否是“已开通”，不然点击右边开通模型权限

调用参数：

  • Base URL：https://ark.cn-beijing.volces.com/api/v3
  • Model Name：doubao-pro-32k、doubao-lite-32k等
  • API Key：你创建的密钥

新用户福利：

  • 注册赠送免费额度
  • 还可以参加截图上方的活动免费获取更多额度，我每天额度都用不完

3. Google AI Studio（国外，官方平台）

网址： https://aistudio.google.com

平台类型： 官方平台

为什么推荐？

  • Google官方平台
  • 有免费额度（有限额）
  • Gemini 3性能顶尖
  • 稳定可靠
  • 支持超长Context（200万Token）
  • 可以在网页直接免费使用，无需写代码

顺便介绍一下怎么免费使用网页版

如果你不想写代码，Google AI Studio提供了非常方便的网页聊天界面，可以直接使用Gemini 3 Pro、Gemini 3 Flash等模型。四舍五入就是付费的Gemini用户。

使用步骤：

  1. 打开 https://aistudio.google.com
  2. 用Google账号登录（需要梯子）
  3. 点击左侧"Playground"PixPin_2026-01-30_11-13-39
  4. 在右上角选择模型：
    • gemini-3-pro：最强模型，适合复杂任务
    • gemini-3-flash：快速模型，适合日常对话
    • 还有其他实验性模型可选PixPin_2026-01-30_11-14-08
  5. 在输入框直接输入你的问题，然后选择“Run”，AI就会回答你的问题PixPin_2026-01-30_11-15-02

高级功能（网页版）：

1. 上传文件

  • 点击输入框右侧的+图标PixPin_2026-01-30_11-16-45
  • 可以上传图片、PDF、文档等
  • 支持多模态理解

2. 调整参数

  • 右边可以调整上一篇介绍过的参数
  • 可以调整：
    • Temperature（创造性）
    • Top P
    • Max output tokens（最大输出长度）
    • Safety settings（安全设置）

网页版的优势：

  • 不需要写代码
  • 不需要安装任何软件
  • 直接在浏览器里用
  • 界面友好，功能齐全
  • 适合快速测试和日常使用

适合谁用网页版？

  • 完全不会编程的新手
  • 想快速测试Gemini效果
  • 日常聊天、问问题
  • 处理文档、图片等多模态任务

获取API Key（适合进阶用户）

回归正题，介绍一下怎么获取API Key。

获取API Key步骤：

  1. 在AI Studio页面，点击左侧"Get API Key"PixPin_2026-01-30_11-18-05
  2. 点击"创建API密钥"PixPin_2026-01-30_11-18-36
  3. 创建并复制生成的API Key
  4. 回到Playground在右侧选择和复制模型名称PixPin_2026-01-30_11-19-41

调用参数：

  • Base URL：https://generativelanguage.googleapis.com/v1beta
  • Model Name：gemini-3-flash-preview
  • API Key：你复制的密钥

免费额度限制

这里需要特别注意！Google AI Studio默认使用免费层级，有以下限制（截至2026年1月），并且这个限制会动态调整：

  • 每分钟请求数（RPM）：15次
  • 每天请求数（RPD）：1500次
  • 每分钟Token数（TPM）：100万Token

详细限制参见：https://ai.google.dev/gemini-api/docs/rate-limits?hl=zh-cn

免费额度够用吗？

对于个人日常使用：

  • 网页聊天：完全够用
  • 偶尔调用API：够用
  • 大量自动化调用：可能不够

如何解除限制？关联你的Cloud Credits！

还记得我们白嫖番外篇讲的"每月10刀Google Cloud额度"吗？现在就可以用上了！

关联步骤：

  1. 在AI Studio回到API界面，点击“设置结算信息”
  2. 关联你之前创建的Google Cloud结算账号PixPin_2026-01-30_11-37-38

关联后的好处：

  • 速率限制大幅提升（RPM可达1000+）
  • 免费额度依然有效
  • 使用强大的flash模型10刀能用很久
  • 网页版和API都享受更高配额

4. OpenRouter（国外，第三方平台）

网址： https://openrouter.ai

平台类型： 第三方平台

为什么推荐？

  • 一个平台调用所有主流AI（GPT、Claude、Gemini等）
  • 价格透明，有时比官方便宜
  • 支持支付宝付款（对国内用户友好）
  • 支持信用卡和加密货币支付
  • 有免费模型可以试用
  • 几乎能调用所有可以调用的模型
  • 榜单令人信服

获取API Key步骤：

  1. 打开 https://openrouter.ai
  2. 点击右上角"Sign In"，用Google或GitHub登录
  3. 登录后点击右上角头像，选择"Keys"PixPin_2026-01-30_11-24-37
  4. 点击"Create Key"
  5. 给Key起个名字，点击创建
  6. 复制生成的Key
  7. 搜索框搜索你要的模型，然后复制名字PixPin_2026-01-30_11-25-45

调用参数：

  • Base URL：https://openrouter.ai/api/v1
  • Model Name：
    • GPT-5.2：openai/gpt-5.2
    • Claude Opus 4.5：anthropic/claude-opus-4.5
    • Gemini 3 Pro：google/gemini-3-pro
    • 免费模型：meta-llama/llama-3.1-8b-instruct:free
  • API Key：你创建的密钥

充值方式：

  • 支付宝（最方便）
  • 信用卡
  • 加密货币（USDC等）

价格优势：

  • 有些模型比官方便宜10-20%
  • 透明定价，网站上直接看价格
  • 不同供应商竞价，你选最便宜的

免费选项：

  • 部分模型完全免费（标注:free的）
  • 新用户有免费额度试用
  • 可以先用免费模型测试

模型排名

  • 在Rankings界面可以看到平台的模型调用数据，榜单十分有说服力PixPin_2026-01-30_11-27-57

其他免费平台

篇幅有限，这里简单提一下其他可以白嫖的平台：

Cerebras（超快推理）

网址： https://cloud.cerebras.ai

特点：

  • 推理速度极快（号称世界最快）
  • 提供免费的Llama模型调用
  • 注册简单，GitHub登录即可

NVIDIA NIM（英伟达官方）

网址： https://build.nvidia.com

特点：

  • 英伟达官方AI平台
  • 提供多个免费模型
  • 适合测试和开发

这两个平台都有免费额度，有兴趣的可以自己注册试试。

总结

三个核心要素：

  1. API Key（密钥）
  2. Base URL（接口地址）
  3. Model Name（模型名称）

四个推荐平台：

  1. DeepSeek官方（官方） - 国内低价首选
  2. 火山引擎（官方+第三方） - 国内平台，可以调用多数国内开源模型
  3. Google AI Studio（官方） - 国外免费首选（配合Cloud Credits），可网页直接用
  4. OpenRouter（第三方） - 多合一平台，支持支付宝

下一篇预告

下一篇我们会讲：如何在实用工具中使用API

这是真正的实战应用教程，包括：

  • 沉浸式翻译：边看外文网页边翻译
  • CherryStudio：强大的AI聚合客户端
  • 闪电说：语音实时转文字+AI总结
  • 如何配置API Key
  • 常见问题及解决方案

不需要会编程，只要会复制粘贴就能用！

如果觉得有帮助，记得关注这个系列！

© 2026 RanceLee的博客
使用 Hugo 构建
主题 Stack 由 Jimmy 设计