快速開始

本頁內容

建立帳號並儲值
建立 API 金鑰
安裝 SDK 並設定金鑰
查詢這把金鑰可用的模型
送出第一個請求
在主控台確認這一筆
下一步

用一把專案 API 金鑰，透過你熟悉的 SDK 呼叫模型，最後在主控台的「請求紀錄」看到這一筆。本頁用 OpenAI 格式示範；Anthropic 與 Gemini 格式見 Anthropic SDK 與 Google GenAI SDK。

開始前需要

ATP Token 帳號：免費註冊
至少 USD 5 的點數（500 點）。沒有點數時請求會回 402。
已安裝 Python 或 Node.js，或只用終端機的 curl。

自己接 API

六個步驟：從儲值到在主控台看到第一筆請求。

用 coding agent 接

Claude Code、Codex、Cline 等工具的設定方式。

建立帳號並儲值#

登入主控台。第一次登入會請你替組織命名。接著到「帳單」按「儲值」，最低 USD 5（500 點），點數不會過期。如果你用的是團隊組織，儲值會先進入你的個人錢包，請再到「資源」把點數撥給要使用的工作區。詳見儲值與錢包。

建立 API 金鑰#

到主控台的「API 金鑰」，按「建立 API 金鑰」。精靈可選擇既有工作區與專案，或在權限允許時建立；接著設定專案可呼叫的模型並產生金鑰。至少勾選一個模型，這把金鑰只能呼叫這些模型。金鑰以 atp- 開頭，完整內容只顯示這一次，請立刻複製。

安裝 SDK 並設定金鑰#

export ATP_API_KEY="atp-your-key"

Gateway 位址是 https://api.atptoken.ai/v1（OpenAI 格式）。金鑰可以放在哪些 header，見驗證方式。

查詢這把金鑰可用的模型#

curl https://api.atptoken.ai/v1/models \
  -H "Authorization: Bearer $ATP_API_KEY"

從清單挑一個模型 ID，下一步會用到。如果清單是空的，表示專案還沒開通模型：到主控台的「資源」替專案加上模型。

送出第一個請求#

把 MODEL_ID 換成上一步挑的模型 ID。

在 Studio 試

curl https://api.atptoken.ai/v1/chat/completions \
  -H "Authorization: Bearer $ATP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "hi"}]
  }'

成功時會收到 OpenAI 格式的回應：choices[0].message.content 是模型的回覆，usage 是這次的 input／output tokens。

JSON

{
  "object": "chat.completion",
  "model": "MODEL_ID",
  "choices": [
    {
      "message": { "role": "assistant", "content": "Hi! How can I help?" },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 9,
    "total_tokens": 17
  }
}

回應	代表什麼	怎麼處理
`401`	金鑰沒帶到、打錯，或已停用	確認 `ATP_API_KEY` 有值、以 `atp-` 開頭；必要時到「API 金鑰」重新建立
`402`	點數用完	到「帳單」儲值；團隊組織再到「資源」撥點數
`403`	這個模型沒有在專案開通	改用第 4 步清單裡的模型 ID，或到「資源」替專案加上模型

其他狀態碼見錯誤碼。

在主控台確認這一筆#

打開主控台的「總覽」，在「最近請求」按「查看全部」，或直接開請求紀錄。剛才的請求會排在最上面，顯示模型、狀態與 input／output tokens；扣掉的點數會算進「用量」。

下一步

這頁有幫助嗎？