發起第一個請求

從控制台複製 Base URL 與金鑰，用 curl / Python / Node.js 幾分鐘完成第一次呼叫。

本指南帶你從零完成第一次 API 呼叫。開始之前，請先確認：

你已經建立 API 金鑰並保存完整金鑰。
你已取得 Base URL：登入控制台，開啟「快速介接」彈窗，選擇協議並複製。以下範例以 https://<your-base-url> 作為佔位符——請替換成你自己的位址。

平台支援三種原生協議，挑選順手的一種即可——三者的計費與餘額完全相同。

OpenAI 相容協議（預設推薦）

與 OpenAI SDK 完全相容：把 base_url 指向平台，既有程式碼就能繼續運作。

cURL

curl https://<your-base-url>/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python（openai SDK）

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://<your-base-url>",
)

completion = client.chat.completions.create(
    model="your-model",
    messages=[{"role": "user", "content": "Hello"}],
)
print(completion.choices[0].message.content)

Node.js（openai SDK）

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://<your-base-url>",
})

const completion = await client.chat.completions.create({
  model: "your-model",
  messages: [{ role: "user", content: "Hello" }],
})
console.log(completion.choices[0].message.content)

Anthropic 協議

與 Anthropic Messages API 同構：以 x-api-key 鑑權並帶上 anthropic-version：

curl https://<your-base-url>/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Gemini 協議

與 Google GenAI API 同構：模型 ID 放在路徑中，鑑權使用 x-goog-api-key：

curl "https://<your-base-url>/v1beta/models/your-model:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'

驗證結果

請求成功時會回傳模型的回覆（OpenAI 協議位於 choices[0].message.content）。接著你可以：

在控制台「帳戶」頁查看用量與餘額變化；
把 your-model 換成模型市場中的真實模型 ID（支援文字、圖像、音訊、影片與檔案模態）。

第一次呼叫常見的錯誤

現象	原因與處理
401 Unauthorized	金鑰錯誤，或金鑰已被刪除 / 過期。確認你使用的是建立時保存的完整金鑰，且沒有多餘空白
找不到模型（Model not found）	模型 ID 拼錯。請從模型市場複製完全一致的 ID
餘額不足（Insufficient balance）	先儲值，再重試

上線建議：把金鑰放在環境變數（例如 OPENAI_API_KEY）而不是寫死在程式碼裡；並優先使用官方 SDK 而非手寫 HTTP 呼叫——SDK 會吸收掉協議相容性的細節。