Gate.AI›博客›Gate.AI 快速入門指南：使用 Python、Node.js 與 curl 存取 API

    Gate.AI 快速入門指南：使用 Python、Node.js 與 curl 存取 API

    指南

    Gate.AI 提供與 OpenAI 相容的 API 介面，開發者可透過 Python、Node.js、curl 及相容的 AI 開發工具發送聊天補全請求。若你已使用 OpenAI 風格的 SDK 或 REST 請求，接入 Gate.AI API 主要僅需更換 API Key 與 Base URL，無需調整請求結構。本文快速入門指南包含一個必要的設定步驟、一次接入路徑選擇，以及 Python、Node.js、curl 三種互斥實作方式。進階主題如串流架構、帳號權限、營運監控與計費控管等，則不在本指南範圍內。

    前置條件

    • 一組 Gate.AI API Key。
    • 已安裝 Python、Node.js 或 curl（依你選擇的接入方式而定）。

    完成本指南後你將獲得什麼能力？

    完成本 Gate.AI API 快速入門指南後，你將能夠透過所選的 Python、Node.js 或 curl 方式，成功向 Gate.AI 發送聊天補全請求。

    你無需完成全部三種語言的範例，只需選擇符合你應用環境的路徑。範例皆採用 Gate.AI 與 OpenAI 相容的 Base URL 及聊天補全格式，並以 2026年6月的產品版本為基礎。如需產品背景，請參閱 Gate.AI 產品頁面。

    步驟1：準備通用 Gate.AI API 設定

    本步驟為所有接入路徑準備通用 API 設定參數。

    操作：

    在選擇實作路徑前，請使用以下 Gate.AI API 設定參數。

    設定項目 值
    API Key YOUR_GATEAI_API_KEY
    Base URL https://api.gate.ai/openai/v1
    聊天補全端點 https://api.gate.ai/openai/v1/chat/completions
    Python 範例模型值 auto
    Node.js 範例模型值 auto
    curl 範例模型值 deepseek/deepseek-v3.2

    API Key 用於請求驗證，Base URL 用於將 OpenAI 相容 SDK 的呼叫導向 Gate.AI。curl 路徑需直接使用 Endpoint。

    步驟2：選擇一種 API 接入路徑

    本步驟旨在避免 Python、Node.js 與 curl 範例被誤認為必須全部執行。

    操作：

    請從下表選擇一種路徑。

    接入路徑 適用情境 所需環境 下一步
    Python 應用、腳本或後端採用 Python Python 與 OpenAI Python SDK 步驟3A
    Node.js 應用或服務採用 JavaScript 或 Node.js Node.js 與 OpenAI Node.js SDK 步驟3B
    curl 需直接終端測試或 REST 除錯請求 curl 步驟3C

    只需完成一種路徑即可驗證 Gate.AI API 接入。僅於需跨多開發環境測試 Gate.AI 時，才需多路徑執行。

    步驟3A：發送 Python 聊天補全請求

    本路徑使用 OpenAI Python SDK 並指定 Gate.AI Base URL。

    操作：

    僅於你的環境為 Python 時使用本路徑。

    1. from openai import OpenAI
    3. client = OpenAI(
    4.     api_key="YOUR_GATEAI_API_KEY",
    5.     base_url="https://api.gate.ai/openai/v1",
    6. )
    8. completion = client.chat.completions.create(
    9.     model="auto",
    10.     messages=[
    11.         {"role": "system", "content": "system prompt"},
    12.         {"role": "user", "content": "how are you?"}
    13.     ],
    14. )
    16. print(completion.choices[0].message.content)

    你會在終端看到助手回覆，例如：

    1. Hello! Nice to meet you. How can I help you?

    本路徑維持 OpenAI Python SDK 的請求結構，僅需將 API Key 與 Base URL 換為 Gate.AI。

    步驟3B：發送 Node.js 聊天補全請求

    本路徑使用 OpenAI Node.js SDK 並指定 Gate.AI Base URL。

    操作：

    僅於你的環境為 Node.js 時使用本路徑。

    1. const OpenAI = require("openai")
    3. const client = new OpenAI({
    4.     apiKey: "YOUR_GATEAI_API_KEY",
    5.     baseURL: "https://api.gate.ai/openai/v1",
    6. })
    8. async function main() {
    9.     const completion = await client.chat.completions.create({
    10.         model: "auto",
    11.         messages: [
    12.             {"role": "system", "content": "system prompt"},
    13.             {"role": "user", "content": "how are you?"}
    14.         ],
    15.     })
    17.     console.log(completion.choices[0].message.content)
    18. }
    20. main()

    你會在主控台看到助手回覆。如果腳本執行無輸出，請列印完整 completion 物件，確認 choices[0].message.content 欄位存在。

    步驟3C：發送 curl 聊天補全請求

    本路徑無需 SDK，直接呼叫 Gate.AI 聊天補全端點。

    操作：

    僅於你需透過終端直接發起 REST 請求時使用本路徑。

    1. curl --location --request POST 'https://api.gate.ai/openai/v1/chat/completions' \
    2. --header 'Authorization: Bearer YOUR_GATEAI_API_KEY' \
    3. --header 'Content-Type: application/json' \
    4. --data-raw '{
    5.     "model": "deepseek/deepseek-v3.2",
    6.     "stream": false,
    7.     "messages": [
    8.         {
    9.             "role": "user",
    10.             "content": "how are you"
    11.         }
    12.     ]
    13. }'

    你將收到包含 choices 陣列的 JSON 回應。助手回覆內容位於 choices[0].message.content 欄位。

    Gate.AI API 成功回應範例

    成功的 Gate.AI 聊天補全回應遵循 OpenAI 相容的結構。

    1. {
    2.     "id": "243c850e-214c-431e-977f-ebaf4aa95f56",
    3.     "choices": [
    4.         {
    5.             "index": 0,
    6.             "message": {
    7.                 "role": "assistant",
    8.                 "content": "Hello! Nice to meet you. How can I help you?"
    9.             },
    10.             "finish_reason": "stop"
    11.         }
    12.     ],
    13.     "created": 1773408946,
    14.     "model": "deepseek.v3-v1:0",
    15.     "object": "chat.completion",
    16.     "usage": {
    17.         "prompt_tokens": 5,
    18.         "completion_tokens": 15,
    19.         "total_tokens": 20
    20.     }
    21. }
    回應欄位 檢查重點
    choices[0].message.content 產生的助手回覆內容
    finish_reason 模型是否正常結束
    model 實際服務請求的模型
    usage.prompt_tokens 輸入訊息消耗的 Token 數
    usage.completion_tokens 助手回覆消耗的 Token 數
    usage.total_tokens 請求與回覆總共消耗的 Token 數

    快速測試時，最重要的欄位為 choices[0].message.content。usage 物件可協助確認 Gate.AI 已處理提示詞與回覆內容。

    Gate.AI API 請求失敗常見原因與排查

    • 症狀：請求回傳驗證錯誤。
      • 原因：API Key 遺漏、過期、格式錯誤或未正確自 Gate.AI 複製。
      • 解法：請將 YOUR_GATEAI_API_KEY 替換為有效的 Gate.AI API Key。對於 curl，需維持 Authorization: Bearer YOUR_GATEAI_API_KEY 標頭格式。
    • 症狀：SDK 請求發送到錯誤服務。
      • 原因：OpenAI SDK 仍使用預設 Base URL。
      • 解法：Python 請設定 base_url，Node.js 請設定 baseURL 為 https://api.gate.ai/openai/v1 後再發送請求。
    • 症狀：回應未使用預期模型。
      • 原因：請求使用 auto，或 Gate.AI 在自動模型選擇時對應不同模型 ID。
    • 症狀：腳本執行但無輸出。
      • 原因：程式未讀取 completion.choices[0].message.content，或請求於列印前已失敗。

    下一步可設定或整合內容

    完成任一 Gate.AI 快速入門 API 路徑後，可將同一 Gate.AI Base URL 整合至你的應用後端、開發工具、內部自動化或測試流程。

    推薦後續主題：

    常見問題解答

    我需要同時執行 Python、Node.js 和 curl 嗎？

    不需要。請依你的開發環境選擇其中一種接入路徑即可。Python、Node.js 和 curl 只是發送 Gate.AI 聊天補全請求的不同方式。

    為什麼 Python 用 base_url，Node.js 用 baseURL？

    Python SDK 採用底線命名（snake_case），Node.js SDK 採用駝峰命名（camelCase）。兩者皆指向同一個 Gate.AI Base URL。

    每次請求都能用 model="auto" 嗎？

    當你希望 Gate.AI 自動選擇模型且你的設定支援時，可以使用 auto。如需指定模型，請參考 Gate.AI 文件選用支援的模型 ID。

    JSON 輸出中的助手回覆在哪裡？

    助手回覆位於 choices[0].message.content 欄位。Token 使用情形則於 usage 物件中獨立顯示。

    相關文章

    如何將 Anthropic API 遷移至 Gate.AI

    如何將 Anthropic API 遷移至 Gate.AI

    如何在 Gate.AI 中設定消費上限與預警

    如何在 Gate.AI 中設定消費上限與預警

    如何打造 Gate.AI 與 LlamaIndex 的整合

    如何打造 Gate.AI 與 LlamaIndex 的整合