Claude API 是什麼?用 Claude API 送出第一則請求

Claude API 是讓程式把問題送給 Claude,再把回答取回來使用的介面。你平常可以在 Claude 聊天網頁貼一則公告,請它改寫。若你想做一個「輸入公告,按一下就產生短通知」的工具,就能讓工具透過 API 替使用者送出這個問題。

下面先分清楚聊天與程式接入的差別,再到管理 API 的網站 Claude Console,用一則虛構公告試跑。接著拆開同一則請求,示範如何用 API 金鑰從自己的電腦送出。金鑰是讓 Claude 驗證程式身分的一串私密文字。最後會帶你找出回覆和用量。

Claude API 是什麼?跟打開 Claude 聊天差在哪?

API 可以理解成程式之間約定好的傳送方式。一個程式按規則把資料送過去,另一端處理後把結果回傳。送去的資料叫請求,送回來的結果叫回覆。用 Claude API 時,請求裡有你交代的工作,回覆裡有 Claude 產生的內容。

什麼時候值得了解 Claude API?

假設你每週整理店內公告。偶爾改寫一則,在 Claude 聊天網頁貼文字、看結果、自己複製就很方便。若同事每天都要從店內表單產生同樣格式的通知,Claude API 就能讓表單背後的程式送出原文,再把回答放回表單的草稿欄,供同事核對。

兩個入口可以試同一個提示詞,也就是你給 Claude 的文字指令。聊天畫面替你安排輸入與顯示。程式接入時,你要決定送什麼、叫哪個模型回答,以及從回覆中取出什麼。模型是實際處理輸入、生成回答的 AI 版本。

公告工具透過 API 送出公告與改寫指令,Claude 產生短通知,再把回覆交回工具。
用 API 改寫公告時,程式送出原文與指令,Claude 回傳結果,程式再把短通知顯示給你。

新手怎麼用 Claude API?先在 Playground 試一則公告

Claude Console 的 Playground 是瀏覽器試跑頁,用的就是 Claude API 收送訊息的功能,官方稱為 Messages API。登入後即可操作,試跑時不用先建立自己的金鑰。

成功試跑會計入 API 用量。送出前先到 Console 的 Billing 頁確認組織有可用點數,或已由 Anthropic 設定月結。

在 Playground 選模型並送出練習文字

  1. 登入 Claude Console 的 Playground。如果畫面請你選工作區,就選你有權使用的測試工作區。工作區是 Console 內區分不同專案或團隊用量的範圍。
  2. 在模型選單選 Claude Sonnet 5.5,或選你工作區中可用的模型。模型名稱和程式所用的識別字串可以在官方模型頁對照。
  3. 把下方虛構公告貼到使用者訊息輸入區,按 Run 送出一次。畫面名稱以官方 Playground 操作說明為準。
  4. 看到回覆後核對店名和兩個時間。範例結果是「青杉書店週三 17 點提早打烊,週四 10 點照常開門。」實際措辭可能不同,週三提早打烊、週四照常開門都要保留。

一句繁中通知,保留星期與時間
青杉書店週三 17 點提早打烊。
週四 10 點照常開門。

在 Playground 看原始回覆時,可以找 content 裡的文字與 usage 的用量。試完後還可以打開 code,複製這次設定對應的程式範例,留給下一節比對。如果你目前只想知道 Claude API 如何接收文字與交回答案,做到這裡就能看清楚一來一回。

在 Console 確認點數或月結、開啟 Playground 選模型、貼公告按 Run,再核對週三與週四的時間。
先確認 Console 計費狀態,再貼上虛構公告按 Run。拿回覆核對週三下午 5 點和週四上午 10 點。

怎麼從自己的程式送出第一則 Claude API 請求?

建立供這次練習使用的 Claude API 金鑰

到 Console 的 API keys 頁按 Create key,取名、選到期日,將 Linked account 設為自己,並指定這次要用的工作區。這樣金鑰的使用範圍就限於該工作區。完整金鑰在建立時顯示一次,請私下保存。建立按鈕若是灰色,可請組織管理員確認你的角色權限。操作名稱見官方金鑰指南。

請把金鑰留在自己控制的地方,避免放進聊天、共用文件或公開網頁。持有人可能用它發送請求,使用量會記在你的 Console 組織。

把剛才的公告放進請求

這是 Claude API 要接收的 JSON,也就是把資料按欄位名稱和值排好的文字。剛才貼在同一格的改寫指令與公告,這裡分開放,讓程式下次只換公告就能沿用指令。

model 填模型識別字串,system 放改寫指令,messages 放公告。role 填 user,表示這是使用者提供的訊息。公告兩行各是一個文字區塊,合在同一則訊息裡。

max_tokens 是這次產生內容的上限,包含模型思考和回答所用的 Token。Token 是模型用來計算用量的文字小片段,想了解這個單位可讀AI Token 入門。

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "system":
  "一句繁中通知,保留星期與時間",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text":
  "青杉書店週三 17 點提早打烊。"
        },
        {
          "type": "text",
          "text":
  "週四 10 點照常開門。"
        }
      ]
    }
  ]
}

用本機終端機送出請求

  1. 開啟官方 Quickstart,在驗證方式選 API key,在 Call the API 選 cURL。cURL 是可以在終端機向指定網址送資料的工具。下方示範用 Windows PowerShell 7 執行。
  2. 把上方從大括號開始的整段 JSON 存成 UTF-8 純文字檔 request.json。它會取代官方範例原本的模型與訊息。若你在 Playground 選了其他模型,把 model 改成官方文件列出的模型 ID。
  3. 在該檔案所在的資料夾開啟 PowerShell 7,貼上下面整段命令。出現輸入提示後貼上金鑰並按 Enter。命令會先把金鑰存到這個視窗的 ANTHROPIC_API_KEY,再用它送出 request.json。
$env:ANTHROPIC_API_KEY =
  Read-Host -MaskInput
$url =
  'https://api.anthropic.com'
$auth = 'Bearer ' +
  $env:ANTHROPIC_API_KEY
$v = '2026-10-21'
$type = 'application/json'
curl.exe "$url/v1/messages" `
  -H "Authorization: $auth" `
  -H "anthropic-version: $v" `
  -H "Content-Type: $type" `
  --data-binary '@request.json'

命令裡的 -H 是在設定請求標頭,也就是和 JSON 一起送出的驗證與格式資訊。上例使用限定工作區的金鑰。若金鑰沒有綁定工作區,依官方驗證說明加上 anthropic-workspace-id,填入 Console 的 Workspaces 頁列出的工作區 ID。其他標頭可查官方 Messages API 規格。

從回覆裡找答案與用量

成功時,Claude API 會回傳一份帶欄位名稱的資料。在 content 找出類型是 text 的區塊,依順序讀取每個區塊的 text。下方用兩個文字區塊示範怎麼組回一句通知,用量數字也是示例。

{
  "content": [
    {
      "type": "text",
      "text":
  "青杉書店週三 17 點提早打烊,"
    },
    {
      "type": "text",
      "text":
  "週四 10 點照常開門。"
    }
  ],
  "usage": {
    "input_tokens": 64,
    "output_tokens": 32
  }
}

usage 裡的 input_tokens 與 output_tokens 分別讓你看這次送入和產生的用量。拿到文字後,再核對店名、週三提早打烊的時間及週四照常開門的時間。

收到回覆後找出文字,核對公告的兩個時間,查看輸入和輸出的 Token 用量,並到 Billing 查看計費。
先找回覆文字,再對照原文的星期與時間。用量看 usage,組織的餘額或帳務看 Billing。

Claude API 回傳錯誤時,先查金鑰或模型

若出現驗證錯誤,先查金鑰是否仍啟用、是否屬於要用的工作區。發現金鑰已外流,就到 API keys 頁停用,再建立新金鑰給需要的程式。若錯誤提到找不到模型,對照該工作區可選的模型和官方 API 模型 ID,再修正欄位。其他訊息可查官方錯誤說明。


Claude API 怎麼收費?有訂閱 Claude 還需要點數嗎?

Claude API 和 Playground 的用量算在 Claude Console 組織。多數組織先使用點數,再依模型及用量扣抵。有與 Anthropic 約定月結的組織則按使用量出帳。做本文的純文字練習時,先看Console Billing有沒有可用點數或已設好的計費方式,送出後再比對用量。點數不足時,預付組織要有新點數入帳才可繼續。細節可查官方 API 計費說明。

Max、Ultra 和 Team 的合格訂閱者可把每月 API 點數領到一個連結的 Console 組織。新訂閱者要滿七天才能領取,Free、Pro 和 Enterprise 不適用這項點數。

Max、Ultra 由訂閱者在 Claude 帳戶的 Billing 操作,Team 由擁有者或主要擁有者在 Claude 團隊的 Billing 操作。按下 Link organization 連結時,操作人在 Console 組織要有 Owner、Admin 或 Billing 其中一種角色。連結完成後,再到 Console Billing 確認點數和到期日。詳見官方每月 API 點數說明。


總結

第一次接觸 Claude API,可以先在 Playground 用虛構公告送一次請求,核對店名和時間,並找到本次用量。要讓自己的工具做同一件事,再到 Console 建立限定工作區的金鑰,從本機送出上面的 JSON,從回覆取出要顯示的文字。

常見問題

用 Claude API 之前,一定要先寫程式嗎?

可以先登入 Claude Console 的 Playground,選模型、輸入一則訊息並按 Run,就能看到回覆與用量。這一步使用 Console 的登入身分,不用自己建立金鑰,仍計入 Console 組織的 API 用量。

訂閱 Claude Pro 可以直接使用 Claude API 點數嗎?

Claude Pro 沒有每月 API 點數。要用 Playground 或串接 API,請到 Claude Console 查看組織有沒有可用點數,或是否已由 Anthropic 設定月結。Max、Ultra 和 Team 的合格訂閱者可把每月 API 點數領到連結的 Console 組織。

Claude API 金鑰貼錯地方怎麼辦?

到 Claude Console 的 API keys 頁立即停用外流的金鑰,再建立新的金鑰。若原本有程式使用舊金鑰,改成讀取新金鑰。也可以到 Console 查該組織的使用紀錄。
分享此內容: