大模型 API 怎么用:从申请 Key 到第一次调用,OpenAI、Claude、Gemini、Grok、DeepSeek 通用入门

大模型 API 怎么用?通用流程:在官方控制台开通账号并充值、创建 API Key、放进环境变量、装 SDK 或用 curl 发第一个请求。附 OpenAI、Claude、Gemini、Grok、DeepSeek 官方示例里的变量名、接口地址和模型名(2026-10 查询)。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-10-25 · 依据官方文档与公开资料整理 其他 账号
本文根据 OpenAI、Anthropic、Google、xAI、DeepSeek 的官方快速入门整理,资料核对于 2026-10-25。模型名和价格更新很快,以官方文档为准。本文不涉及购买或共享 Key,只讲官方自助开通的流程。图为本站整理的示意图。

适用于谁

  • 搜「大模型 api 怎么用」「api key 怎么用」的人;
  • 会一点编程、想第一次调用大模型接口的人;
  • 想知道各家官方入门流程有什么共同点和差别的人。

结论先说

  1. 订阅和 API 是两套东西:ChatGPT、Claude、Gemini、Grok 的会员用来使用它们的应用;API 要在各家的开发者控制台里单独开通,按 token 计费。会员选择见 /guides/ai-subscription-which-to-choose-four-vendors。
  2. 通用流程是五步:开通开发者账号(多数先充值)、创建 API Key、放进环境变量、装 SDK 或直接发 HTTP 请求、发出第一个请求并核对用量。
  3. Key 不要写进代码:几家官方示例都是先把 Key 导出为环境变量(OpenAI 是 OPENAI_API_KEY,Anthropic 是 ANTHROPIC_API_KEY,xAI 是 XAI_API_KEY),SDK 自动读取。
  4. 模型名要用官方当前的:下表是官方示例里用的模型,随时会更新。
  5. 先小量试:第一次调用先用最便宜的模型、很短的输入,再看价格和用量,价格见 /guides/llm-api-price-comparison-official。

从 Key 到第一次调用的 5 步

图:本站根据各家官方快速入门整理的示意图

一、五家官方快速入门的关键信息

五家官方快速入门的关键信息

图:本站根据各家官方开发者文档整理的示意图

厂商开通与 Key环境变量接口示例模型
OpenAI在开发者控制台创建 API KeyOPENAI_API_KEY官方 SDK,示例用 Responses 接口gpt-6-astra
AnthropicClaude Console 账号加 API KeyANTHROPIC_API_KEYhttps://api.anthropic.com/v1/messagesclaude-opus-5-5
Google在 Google AI Studio 创建 KeyGEMINI_API_KEYInteractions APIgemini-4-argon
xAIconsole.x.ai 注册并充值,API Keys 页面创建XAI_API_KEYhttps://api.x.ai/v1,Responses 接口grok-4.7
DeepSeek开放平台创建 Key(见站内教程)示例里自行设置OpenAI 格式 https://api.deepseek.com,Anthropic 格式 https://api.deepseek.com/anthropicdeepseek-flash

各家 Key 的详细创建步骤见站内教程:/guides/openai-api-key、/guides/claude-api-key-console、/guides/gemini-api-key、/guides/grok-api-pricing-api-key、/guides/deepseek-api-key。

二、第一次调用:官方示例里的写法

OpenAI(JavaScript)

先导出变量并安装 SDK:

bash
export OPENAI_API_KEY="your_api_key_here"
npm install openai

官方示例代码:

javascript
import OpenAI from "openai";
const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-6-astra",
  input: "Write a one-sentence bedtime story about a unicorn.",
});

console.log(response.output_text);

Windows PowerShell 里官方给的导出写法是 setx OPENAI_API_KEY "your_api_key_here",之后要重新打开终端才生效。Python 版见 /guides/openai-api-python-quickstart。

Anthropic(curl)

bash
export ANTHROPIC_API_KEY="your-api-key-here"

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1000,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

官方说明返回的是包含助手消息的 JSON,其中有 usage 里的输入和输出 token 数。注意 Anthropic 的请求必须带 max_tokens。

Gemini(Python)

官方最新模型页的最小示例(需要已设置 GEMINI_API_KEY):

python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
    model="gemini-4-argon",
    input="Write a haiku about the sea."
)
print(interaction.output_text)

注意 gemini-4-argon 没有免费层;想先免费试,可以换成有免费层的模型,价格与免费层见 /guides/gemini-api-price-official 和 /guides/gemini-api-free-tier-rate-limits。Python 入门见 /guides/gemini-api-python-quickstart。

xAI(Python,用 OpenAI SDK)

python
from openai import OpenAI

client = OpenAI(
    api_key="<YOUR_XAI_API_KEY_HERE>",   # 实际使用时从环境变量读取
    base_url="https://api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.7",
    input="Say hello in one sentence.",
)
print(response.output_text)

xAI 的 API 兼容 OpenAI SDK,只要把 base_url 换成官方地址。注意示例里的 Key 只是占位,不要把真实 Key 写进代码。

DeepSeek

官方定价页写明两种兼容格式:OpenAI 格式的接口地址是 https://api.deepseek.com,Anthropic 格式是 https://api.deepseek.com/anthropic,模型名用 deepseek-flash 或 deepseek-v4-pro。所以用 OpenAI 的 SDK 时,把 base_url 换成 DeepSeek 的地址、model 换成 deepseek-flash 即可。充值和余额见 /guides/deepseek-api-platform-balance-topup。

三、第一次调用常见的坑

现象常见原因
401 或鉴权失败环境变量没设对、终端没重开、Key 复制时多了空格
提示余额不足或需要付款多数平台要先充值或开通计费;xAI 官方说要先充值才能用 API
429请求太快或额度用完,见 /guides/openai-api-429-error、/guides/gemini-api-429-resource-exhausted
模型不存在模型名过期,或你的账号没有该模型权限;到官方模型页核对
返回被截断输出上限太小;Anthropic 要显式写 max_tokens

四、安全和成本

  • Key 等同于付费凭据:泄露后别人可以消耗你的余额。放环境变量,不要提交到代码仓库,定期轮换;
  • 只信官方渠道:从各家官方控制台自己创建 Key;官方不授权转售,也别把 Key 交给来历不明的「中转」或共享服务;
  • 设支出上限:能设预算或上限的平台先设好;
  • 先小量试:用短输入和便宜模型,核对账单后再放大。

常见问题

Q:订阅了 ChatGPT Plus 或 Claude Pro,API 能直接用吗?

不能。订阅和 API 分开计费、分开开通,Claude 的区别见 /guides/claude-subscription-vs-api。需要 ChatGPT 或 Claude 会员可看 /chongzhi/chatgpt-plus 和 /chongzhi/claude-pro。

Q:不会写代码能用 API 吗?

可以用 Cherry Studio、Chatbox 这类客户端填入 Key,见 /guides/deepseek-cherry-studio-chatbox。

Q:想让 AI 自己调用工具、做多步任务呢?

那是智能体,见 /guides/ai-agent-what-is-examples。

参考资料

  • OpenAI:Developer quickstart — https://developers.openai.com/api/docs/quickstart
  • Anthropic:Get started with Claude — https://platform.claude.com/docs/en/get-started
  • Gemini API:最新模型 — https://ai.google.dev/gemini-api/docs/latest-model
  • Gemini API:API keys — https://ai.google.dev/gemini-api/docs/api-key
  • xAI:Quickstart — https://docs.x.ai/developers/quickstart
  • DeepSeek:模型与价格 — https://api-docs.deepseek.com/quick_start/pricing
需要开通或续费?AI 会员充值与全部商品 →

Nathaniel 的更多内容

  1. 01

    Claude 登录报错对照(账号被停用以外):There was an error logging you in、收不到登录邮件、验证码、Google 登录的处理

    Claude 登录不上,除了账号被停用,还有登录出错、收不到登录邮件、在另一台设备点链接、想设密码、Google 登录异常等情况。本文按官方登录帮助整理各提示的原文和处理,账号被停用另见专门文章。

    Claude0
  2. 02

    Claude 提示「Something went wrong」怎么办:限额、消息过长、容量紧张、登录出错的官方报错对照

    Claude 报 Something went wrong 或别的错误?官方《Troubleshoot Claude error messages》把常见错误分成限额、消息过长、登录出错、容量紧张四类,并给了各自的原文和处理。本文逐项整理,并说明官方没有单独解释笼统的出错提示。

    Claude0
  3. 03

    DeepSeek 除了「服务器繁忙」还有哪些报错:网页版提示对照和 API 错误码 400、401、402、422、429、500、503

    DeepSeek 报错不只有服务器繁忙。本文把官方常见问题里的网页版提示(上传失败、运行环境异常、账号停用、邮箱域名不支持)和 API 错误码汇成对照表,给出官方的原因和处理,并链到各篇详细文章。

    其他 AI 工具0
  4. 04

    Gemini 提示「此账号无法使用」(Can't access this service)怎么办:账号类型、年龄、Family Link 与工作学校账号的官方条件

    Gemini 提示 Can't access this service,意思是这个账号目前不符合使用条件。官方写明了可用的账号类型、年龄要求和 Family Link 账号不能用。本文按账号类型对照,并给出 Something went wrong 的处理。

    Gemini0
  5. 05

    Gemini Pro 免费试用、学生优惠到期后怎么办:自动转付费、重新验证 SheerID、取消后会失去什么

    Google AI Pro 学生优惠或试用到期后会怎样?官方说会自动转为正常付费的 Plus 或 Pro,会提前通知;没有按时重新验证 SheerID 会失去优惠。本文按官方帮助中心整理到期规则、取消后失去的内容和第三方订阅的处理。

    Gemini0
  6. 06

    Gemini 怎么切换模型:Flash-Lite、Flash、Pro、Argon 的选择步骤、思考等级和自动选择

    Gemini 网页版怎么手动切换模型?官方步骤是点聊天框底部当前模型再选,需要有 Google AI 方案,带锁图标的要升级。本文按官方说明整理各方案可选模型、思考等级默认值和自动模型选择。

    Gemini0

同产品的其他教程

  1. 01

    AI 工具都打不开时怎么判断是谁的问题:ChatGPT、Gemini、Claude、DeepSeek、Grok、Kimi 官方状态页地址汇总

    好几个 AI 同时打不开,是你的网络,还是某一家出了故障?本文汇总 ChatGPT、Claude、Gemini、DeepSeek、Grok、Cursor、Kimi、GitHub Copilot 的官方状态页地址,说明各家页面上该看哪一项,以及先判断自己网络、再逐家看状态页的顺序。

    其他 AI 工具0
  2. 02

    DeepSeek 是不是崩了:官方状态页 status.deepseek.com 怎么看,聊天、联网搜索、API 分别看哪一项

    DeepSeek 打不开、一直转圈或报错,先看官方状态页 status.deepseek.com,不用登录。本文讲清页面上对话、上传文件、搜索、V4 Pro 与 V4.1 Flash 接口等服务项各管什么、怎么看历史事件和订阅通知,以及页面显示正常时下一步怎么排查。

    其他 AI 工具0
  3. 03

    AI 智能体是什么、有哪些:官方怎么定义、和普通聊天机器人的区别、ChatGPT、Claude、Gemini、Grok 的现成产品

    AI 智能体是什么?OpenAI 官方说它是「独立替你完成任务的系统」,由模型、工具和指令组成;Anthropic 把预先写好步骤的叫工作流,模型自己决定步骤的才叫智能体。附 ChatGPT、Claude、Gemini、Grok 的现成产品和注意事项。

    其他 AI 工具0
  4. 04

    AI 视频生成工具怎么选:Gemini(Omni、Veo、Flow)和 Grok Imagine 按官方说明对比时长、分辨率和价格

    AI 视频生成工具怎么选?按官方说明对比:Gemini 用 Omni 和 Veo,在 Flow 里单段 4 到 10 秒;Grok Imagine 官方写最长 15 秒,API 最高 1080p;价格分别是 Flow 点数和 Grok 周用量池(2026-10 查询)。

    其他 AI 工具0
  5. 05

    AI 生图工具怎么选:ChatGPT 图片、Gemini(Nano Banana)、Grok Imagine 按官方说明对比额度、水印和 API 价格

    AI 生图工具怎么选?按官方页面对比:ChatGPT 免费版有限、Plus 更精细、Pro 无限;Gemini 免费版就有图片生成与编辑;Grok 带水印;Claude 不生成照片和插画。附 Gemini 和 Grok 的 API 单价(2026-10 查询)。

    其他 AI 工具0
  6. 06

    AI 编程工具怎么选:Codex、Claude Code、Cursor、Antigravity CLI(原 Gemini CLI)按订阅和额度来源对比

    AI 编程工具怎么选?按官方说明对比 Codex、Claude Code、Cursor 和 Antigravity CLI:额度分别来自 ChatGPT、Claude、X 订阅和 Google AI 套餐,起步价约 8 到 20 美元每月;Gemini CLI 个人账号路径已停止(2026-10 查询)。

    Codex其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~