大模型 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 條評論

登入 後參與評論

還沒有評論,來搶沙發~