API 接取

2026 年 9 月 22 日 · AIAdapter · https://www.aiadapter.com

AIAdapter 提供 OpenAI 相容 API。一個帳戶只簽發一把 API 金鑰。桌面用戶端與應用程式碼都使用同一把金鑰。不要依模型、廠商或用戶端再開第二把。

僅在呼叫非正式環境時替換下方來源。路徑 /v1 不可省略。

1. 憑證

登入後開啟控制台 → API Keys，建立一次即可。金鑰只在建立時完整顯示，請立刻保存，之後在所有接取點重用。

欄位	值
Base URL	https://www.aiadapter.com/v1
驗證	Authorization: Bearer <API_KEY>
模型 ID	/models 上列出的識別碼

官方 OpenAI 用戶端會在 Base URL 後接上 /chat/completions 等路徑。請指向 …/v1，不要指向站台根路徑。

金鑰是機密。不要寫入儲存庫、工單，也不要放進瀏覽器 JavaScript、行動應用或其他終端使用者可檢視的用戶端。從環境變數或密鑰管理服務讀取。若已外洩，刪除後只再建立一把替換金鑰。

2. 直接呼叫（不寫接取程式碼）

若只需在既有 OpenAI 相容應用中呼叫模型、不寫接取程式碼，走本節。常見用戶端包括 Cursor、Claude Desktop、Cherry Studio、Continue、LibreChat。

只設定三個欄位。金鑰就是控制台簽發的那一把。

Cursor

開啟 Settings → Models。
將 API 金鑰貼到 OpenAI API Key。
開啟 Override OpenAI Base URL，填 https://www.aiadapter.com/v1（v1 小寫）。
在 Custom Models 加入模型市場中的識別碼。盡量避開與 Cursor 內建模型同名的 ID。

Cursor Tab 與部分內建模型不會走自訂 OpenAI Base URL。覆寫生效後，請用市場模型 ID 發起對話。若欄位無法聚焦，請將 Cursor 升級至 3.15.20 或更新版本。

其他 OpenAI 相容用戶端

在 Claude Desktop、Cherry Studio、Continue、LibreChat 或任何接受 OpenAI 相容提供方的用戶端中：

提供方 / API 類型：OpenAI compatible
Base URL：https://www.aiadapter.com/v1
API key：這一把 AIAdapter 金鑰
模型：市場識別碼

不要為第二個用戶端再開一把金鑰。兩台用戶端共用同一把金鑰是預期用法。

3. 應用接取

自行撰寫軟體時走本節。契約不變：一把金鑰、一個 Base URL、Bearer 驗證。下列範例把官方 OpenAI 函式庫當作可替換用戶端。

在行程環境設定 AIADAPTER_API_KEY，不要把金鑰寫進原始碼。把 MODEL_ID 換成 /models 上的完整識別碼，包含賣方前綴。

HTTP

curl https://www.aiadapter.com/v1/chat/completions \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Reply with one word: ok"}]
  }'

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIADAPTER_API_KEY"],
    base_url="https://www.aiadapter.com/v1",
)
response = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "Reply with one word: ok"}],
)
print(response.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AIADAPTER_API_KEY,
  baseURL: "https://www.aiadapter.com/v1",
});
const response = await client.chat.completions.create({
  model: "MODEL_ID",
  messages: [{ role: "user", content: "Reply with one word: ok" }],
});
console.log(response.choices[0].message.content);

4. 模型與端點

用同一把 Bearer 金鑰呼叫 GET /v1/models，或瀏覽 /models。將列出的識別碼填入 model。識別碼帶賣方前綴，請原樣複製。例如 pixverse/c1、byteplus-intl/dreamina-seedance-2-5-260628。不要只填 c1 或 seedance-2.5。

常見 OpenAI 相容路由：

POST /v1/chat/completions — 對話與語言模型
POST /v1/images/generations — 影像模型
POST /v1/video/generations，再 GET /v1/video/generations/{id} — 影片模型

影像

生圖是同步的。把市場識別碼填進 model。

curl https://www.aiadapter.com/v1/images/generations \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus-intl/dola-seedream-5-0-flash-260915",
    "prompt": "A red paper lantern in rain"
  }'

影片

提交後立刻回傳 job。用該 job id 輪詢同一路徑，直到成功或失敗。不要把成片等在提交這一條請求上。

curl https://www.aiadapter.com/v1/video/generations \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse/c1",
    "prompt": "A cat walking across a sunlit kitchen",
    "seconds": "5"
  }'

curl https://www.aiadapter.com/v1/video/generations/JOB_ID \
  -H "Authorization: Bearer $AIADAPTER_API_KEY"

音訊及其他模態以該模型在市場上的說明為準。

401 表示金鑰缺失或無效。429 表示觸發限速。餘額或額度不足時介面會回傳錯誤，請先在控制台儲值再重試。

5. 金鑰使用

帳戶上的全部接取用一把金鑰即可。額外開鑰會拆散稽核軌跡並增加外洩面，不會解鎖更多模型。

詢問：help@aiadapter.com