Source: https://ailoot.ai/docs/zh-hant-tw/ Canonical: https://ailoot.ai/docs/zh-hant-tw/ Language: zh-hant-tw [入門](https://ailoot.ai/docs/zh-hant-tw/) # 快速入門 — AI API 價格與串接步驟 [Markdown](https://ailoot.ai/docs/zh-hant-tw/index.md) 幾分鐘內透過 Ailoot 取得模型的第一個回應：金鑰、位址與一次請求。 Ailoot 提供統一 API，可使用不同公司的 AI 模型：OpenAI、Anthropic、Google、xAI、DeepSeek、Alibaba、Moonshot、Z.ai、MiniMax、NVIDIA、Meta、Poolside與TypeSafe。一把金鑰、統一的美元餘額。目錄中有 1256 張模型卡片與 2692 個已記載的方法。如有其他呼叫識別碼或別名，會列在所選方法下方。 Ailoot 支援三種 API 格式：OpenAI、Anthropic與Gemini。因此可使用現成 SDK，以及幾乎所有可自訂 API 位址的應用程式，例如 Claude Code、Codex CLI、Cline、Cursor、Open WebUI、n8n與其他數十種工具。 | 方式 | 適用情境 | | --- | --- | | [HTTP 請求](https://ailoot.ai/docs/zh-hant-tw/connect/curl/) | 任何語言，不需相依套件，可快速驗證金鑰 | | [OpenAI SDK](https://ailoot.ai/docs/zh-hant-tw/connect/openai-sdk/) | Python與Node.js；目錄中採用 OpenAI 格式的任何模型 | | [Anthropic SDK](https://ailoot.ai/docs/zh-hant-tw/connect/anthropic-sdk/) | 採用 Messages 格式的 Claude與其他模型 | | [現成應用程式](https://ailoot.ai/integrations/zh-hant-tw/) | 85 種代理、編輯器與聊天應用程式：77 種有現成設定，另有 8 種仍在檢查中 | 需要特定程式？請開啟[整合目錄](https://ailoot.ai/integrations/zh-hant-tw/)：每個項目都說明應在哪裡填入位址與金鑰，並提供可直接複製的設定。 ## [](https://ailoot.ai/docs/zh-hant-tw/#key)取得金鑰 1. **註冊** 在此網站建立帳戶：[ailoot.ai/register](https://ailoot.ai/register)。之後可透過此位址登入：[ailoot.ai/login](https://ailoot.ai/login)。 2. **儲值** 在控制台開啟「方案」區，可選擇最低 $18 的單次儲值，或附帶贈送額度的訂閱。詳細說明：[儲值](https://ailoot.ai/docs/zh-hant-tw/billing/topup/)與[訂閱](https://ailoot.ai/docs/zh-hant-tw/billing/subscriptions/)。 3. **建立 API 金鑰** 在控制台開啟金鑰區，並建立新的金鑰。金鑰以此開頭：`sk-`。可在控制台的金鑰區複製，請像密碼一樣妥善保管。 將金鑰保存於環境變數 ```bash export AILOOT_API_KEY="sk-..." # 檢查：應傳回模型清單 curl -s https://api.ailoot.ai/v1/models -H "Authorization: Bearer $AILOOT_API_KEY" | head -c 300 ``` ## [](https://ailoot.ai/docs/zh-hant-tw/#first-request)傳送第一個請求 API 位址為`https://api.ailoot.ai`。OpenAI 格式的 SDK，基礎位址為`https://api.ailoot.ai/v1`，Anthropic與Gemini 則為`https://api.ailoot.ai` ，不加後綴，因為這些 SDK 會自行補上路徑。 ```bash curl https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-5-5", "messages": [ {"role": "user", "content": "用兩句話解釋 API 是什麼。"} ] }' ``` ```python from openai import OpenAI import os client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"], ) resp = client.chat.completions.create( model="claude-sonnet-5-5", messages=[{"role": "user", "content": "用兩句話解釋 API 是什麼。"}], ) print(resp.choices[0].message.content) ``` ```js import OpenAI from "openai"; const client = new OpenAI({ maxRetries: 0, baseURL: "https://api.ailoot.ai/v1", apiKey: process.env.AILOOT_API_KEY, }); const resp = await client.chat.completions.create({ model: "claude-sonnet-5-5", messages: [{ role: "user", content: "用兩句話解釋 API 是什麼。" }], }); console.log(resp.choices[0].message.content); ``` ```python import anthropic import os client = anthropic.Anthropic(max_retries=0, base_url="https://api.ailoot.ai", # 不加 /v1：SDK 會自行加上 /v1/messages api_key=os.environ["AILOOT_API_KEY"], ) msg = client.messages.create( model="claude-sonnet-5-5", max_tokens=1024, messages=[{"role": "user", "content": "用兩句話解釋 API 是什麼。"}], ) print(msg.content[0].text) ``` 回應會採用熟悉的格式。此區塊`usage`會顯示問題與回應使用的 token 數，扣款依據這些數值計算。 200 OK ```json { "id": "chatcmpl-8f2c…", "object": "chat.completion", "created": 1790812800, "model": "claude-sonnet-5-5", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "API 是一套約定，讓一個程式能請另一個程式執行工作…" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 21, "completion_tokens": 48, "total_tokens": 69 } } ``` ## [](https://ailoot.ai/docs/zh-hant-tw/#streaming)串流回應 使用`"stream": true`時，回應會像原始 API 一樣，以 Server-Sent Events 格式傳回，因此 SDK與用戶端不需修改解析方式。使用 OpenAI SDK 時，可方便地要求在最後一個事件取得最終`usage`資料。 Ailoot 會在費用計算完成後傳回付費文字回應。因此，使用`stream: true`時，格式仍是串流 (SSE)，但文字會在模型完成後以單一區塊傳回，而非逐字傳回。若回應準備時間超過約 15 秒，Chat Completions、Responses與Messages 串流會先傳送服務訊息`: ping` (約每 10 秒一次)，接著傳送`: ailoot-charged-usd …` ，其中包含扣款金額，最後傳送實際資料。SDK 會略過這類服務訊息。 ```python stream = client.chat.completions.create( model="gpt-6.1-sol", messages=[{"role": "user", "content": "寫一首關於雨的俳句"}], stream=True, stream_options={"include_usage": True}, ) for chunk in stream: if chunk.choices and chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True) ``` ```js const stream = await client.chat.completions.create({ model: "gpt-6.1-sol", messages: [{ role: "user", content: "寫一首關於雨的俳句" }], stream: true, stream_options: { include_usage: true }, }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content ?? ""); } ``` ```bash curl -N https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gpt-6.1-sol", "stream": true, "messages": [{"role": "user", "content": "寫一首關於雨的俳句"}]}' ``` ## [](https://ailoot.ai/docs/zh-hant-tw/#models)選擇模型 欄位`model` —確切的識別碼，取自[模型目錄](https://ailoot.ai/models/zh-hant-tw/)或此回應：`GET /v1/models`。許多模型有簡短別名，例如`claude-sonnet-latest`或`qwen`。目錄會顯示別名目前指向的模型；若要可重現的結果，請使用確切的 ID。 | 用途 | 從哪裡開始 | | --- | --- | | 程式開發與代理 | `claude-sonnet-5-5`，`gpt-6.1-sol`，`claude-opus-5-5` | | 快速且價格低 | `gemini-3.8-flash`，`deepseek-v4.1-flash`，`qwen3.8-flash` | | 長上下文，最多 1M token | `claude-sonnet-5-5`，`deepseek-v4-pro`，`qwen3.8-max` | | 影像 | `gpt-image-2.5`，`gemini-3.1-flash-image`，`grok-imagine-image-2.0` | 並非每個模型都支援所有格式。例如，Gemini 模型可透過 Anthropic Messages與原生 Gemini 格式使用；OpenAI Chat 則僅支援`gemini-3.6-flash`。模型支援哪些格式，可在此處查看：[目錄](https://ailoot.ai/models/zh-hant-tw/)。 ## [](https://ailoot.ai/docs/zh-hant-tw/#next)接下來 [**運作方式** 請求路徑、保留金額、扣款與錯誤](https://ailoot.ai/docs/zh-hant-tw/how-it-works/) [**相容性** 支援的格式與用戶端](https://ailoot.ai/docs/zh-hant-tw/compatibility/) [**整合** 77 種提供現成設定的應用程式](https://ailoot.ai/integrations/zh-hant-tw/) [**錯誤與限制** 回應代碼與處理方式](https://ailoot.ai/docs/zh-hant-tw/errors/) 還有疑問嗎？請提供 Request ID與問題描述，我們會協助釐清。[聯絡支援](mailto:support@ailoot.ai) ## AI API 價格與串接步驟 ### 如何支付 Ailoot API 的費用？ 在控制台開啟「方案」區，可選擇最低 $18 的單次儲值，或附帶贈送額度的訂閱。詳細說明：儲值與訂閱。 將 Ailoot 串接 Claude Code、OpenCode、Hermes 或自己的應用程式。 ## 公司及其專案組合 公司及其專案組合：數百萬客戶，每月銷售額達數十億。 ## 優惠購買 token。 訂閱優惠適合持續工作，折扣碼購買 token 最高可折 50%。 訂閱 為定期請求選擇優惠方案。 最高 50% 折扣碼 購買時輸入代碼，價格依活動重算。 歷史中的費用 每次請求保存模型、token 與金額。 [選擇訂閱](https://ailoot.ai/docs/zh-hant-tw/billing/subscriptions/) · [查看模型價格](https://ailoot.ai/models/zh-hant-tw/) ## 將 API 加入 你銷售的產品。 依 Ailoot 正式服務條款與授權合約串接 SaaS、應用程式與機器人；轉售請申請經銷授權。 商用應用程式 在付費功能加入文字、圖片、影片與聲音生成。 經銷授權 提供專案說明與存取方式，要求書面使用和轉售條件。 網站文件 串接前可閱讀正式服務條款、授權合約與資料處理政策。 [申請經銷授權](mailto:support@ailoot.ai) · [正式服務條款與授權合約](https://ailoot.ai/legal/offer?lang=zh-hant-tw) ## 常見問題 如何傳送第一個 API 請求？ 建立 Ailoot API 金鑰。OpenAI SDK 設為 https://api.ailoot.ai/v1，Anthropic 與 Gemini SDK 設為 https://api.ailoot.ai。免費的 GET /v1/models 會列出金鑰可存取的模型；接著使用所選模型與 API 方法的範例。 應使用哪個 API 金鑰？ 在所選用戶端格式的驗證欄位中，使用您帳號內的 Ailoot API 金鑰。以同一金鑰傳送 GET /v1/models，即可免費檢查模型存取權；其他服務的金鑰無法用來存取 Ailoot。 第一個請求失敗時應檢查什麼？ 依模型卡片與請求範例核對 API 位址、Ailoot API 金鑰、確切的模型 ID 及 API 方法。閱讀傳回的錯誤；需要協助時，請將錯誤與請求 ID 寄至 support@ailoot.ai，勿附上 API 金鑰。 訂閱提供什麼？ 持續工作可優惠購買 token。按請求量選方案，訂閱條件與費用在申購時顯示。 如何使用最高 50% 折扣碼？ 購買 token 時輸入折扣碼，總額依活動條件重算，付款前即可看到優惠。 ## Ailoot · 公司及其專案組合 Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。 公司及其專案組合：數百萬客戶，每月銷售額達數十億。 Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。