開發者中心

本站所有 API 的整合入口。

本站提供 OpenAI 相容、Anthropic 相容、Google 與 OpenRouter 中繼 API，另有站台原生工具 API（Google 搜尋／新聞、對話、點數查詢）與 MCP 伺服器。用量以帳號點數計費；呼叫失敗一律不收費。

快速上手

curl https://<host>/ntl/api/openai/v1/chat/completions \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Hello"}]}'

各中繼實際接受的模型清單可用 GET /ntl/api/openai/v1/models 或 GET /ntl/api/anthropic/v1/models 查詢——回傳清單即中繼接受的全部模型，其餘模型一律回 No pricing info! Please use other models! 拒絕。

Base URL 一覽

OpenAI-compatible     /ntl/api/openai/v1
Anthropic             /ntl/api/anthropic/v1
Google                /ntl/api/google/v1beta
OpenRouter-compatible /ntl/api/openrouter/v1

認證方式

請先在「開發者金鑰」頁面建立 API 金鑰，之後每次請求都帶上：

Authorization: Bearer <API_KEY> — 全部端點皆適用（建議使用）。
x-api-key: <API_KEY> — Anthropic 端點亦接受（相容官方 SDK）。
x-goog-api-key: <API_KEY> — Google 端點亦接受（相容官方 SDK）。

請勿將 API 金鑰放在網址 query string——網址會被記錄在存取紀錄與瀏覽器歷史。各端點一律不接受以 query 參數傳遞金鑰。

端點總覽

OpenAI 相容中繼

端點	方法	描述
`/ntl/api/openai/v1/models`	GET	列出支援的 OpenAI 模型（由計價表產生）。
`/ntl/api/openai/v1/models/{model}`	GET	查詢單一模型（相容 SDK `client.models.retrieve`）。
`/ntl/api/openai/v1/chat/completions`	POST	Chat Completions 中繼（支援串流；`web_search_options` 依實際使用次數計費）。
`/ntl/api/openai/v1/responses`	POST	Responses API 中繼（支援串流；`web_search` 工具依實際使用次數計費）。
`/ntl/api/openai/v1/embeddings`	POST	Embeddings 中繼（OpenAI 相容請求／回應；接受模型：`voyage-4`、`voyage-4-large`——依 input token 計費）。
`/ntl/api/openai/v1/images/generations`	POST	圖片生成中繼。
`/ntl/api/openai/v1/audio/speech`	POST	文字轉語音中繼（回傳音訊二進位檔）。
`/ntl/api/openai/v1/audio/transcriptions`	POST	語音轉文字中繼（multipart 上傳）。
`/ntl/api/openai/v1/audio/translations`	POST	語音翻譯為英文（multipart 上傳）。
`/ntl/api/openai/v1/audio/voices`	POST	自訂語音建立中繼。

Anthropic 中繼

端點	方法	描述
`/ntl/api/anthropic/v1/models`	GET	列出支援的 Anthropic 模型。
`/ntl/api/anthropic/v1/models/{model_id}`	GET	查詢單一模型（相容 SDK `models.retrieve`）。
`/ntl/api/anthropic/v1/messages`	POST	Messages 中繼（支援串流、prompt caching 與 thinking；`web_search` 伺服器工具依實際使用次數計費；code execution 等其他伺服器端／託管工具不支援——詳見說明文件）。
`/ntl/api/anthropic/v1/messages/count_tokens`	POST	Token 計數中繼（免費）。

Google 中繼

端點	方法	描述
`/ntl/api/google/v1beta/models`	GET	列出支援的 Google 模型（由計價表產生）。
`/ntl/api/google/v1beta/models/{model}`	GET	查詢單一模型。
`/ntl/api/google/v1beta/models/{model}:generateContent`	POST	Gemini 對話／視覺／圖片生成中繼。
`/ntl/api/google/v1beta/models/{model}:streamGenerateContent`	POST	Gemini 串流中繼（SSE）。
`/ntl/api/google/v1beta/models/veo-*:predictLongRunning`	POST	Veo 影片生成（長時間作業）。
`/ntl/api/google/v1beta/models/lyria-*:predict`	POST	Lyria 音樂生成。
`/ntl/api/google/v1beta/operations/{name}`	GET	查詢長時間作業狀態（免費）。

OpenRouter 中繼

端點	方法	描述
`/ntl/api/openrouter/v1/models`	GET	列出 OpenRouter 模型（代理官方清單，快取 10 分鐘）。
`/ntl/api/openrouter/v1/chat/completions`	POST	Chat Completions 中繼至 OpenRouter（支援數百個 `vendor/model` 模型 id）。
`/ntl/api/openrouter/v1/chat/responses`	POST	請求／回應格式與上列 Chat Completions 相同（並非 OpenAI Responses API 格式）——此端點另會在轉發前先檢查點數餘額。
`/ntl/api/openrouter/v1/audio/speech`	POST	文字轉語音中繼。
`/ntl/api/openrouter/v1/audio/transcriptions`	POST	語音轉文字中繼（multipart 上傳）。
`/ntl/api/openrouter/v1/video/generations`	POST	影片生成中繼。

站台原生 API

端點	方法	描述
`/ntl/api/google/search`	GET	Google 網頁搜尋（回傳結構化 JSON 結果）。
`/ntl/api/google/news`	GET	Google 新聞搜尋（JSON 結果，附還原後的文章網址）。
`/ntl/api/user/get_credits`	GET	查詢剩餘點數（免費）。
`/ntl/ai/chat/chat`	POST	站台原生對話端點（SSE 串流；本站已開通的任何對話模型皆可使用）。

不支援項目

以下 vendor 端點「不」由本中繼提供——呼叫會回 404（支援端點內的託管工具則回 400）。請勿依 SDK 介面自行猜測：

OpenAI /v1/batches（Batch API 折扣層）、/v1/files、/v1/fine_tuning、/v1/assistants、/v1/vector_stores。
Responses 內的 OpenAI 託管工具（code_interpreter／file_search／image_generation／computer use）——一律回 400 拒絕；僅支援 web_search。
Anthropic /v1/files、/v1/messages/batches，以及 web_search 以外的伺服器端工具（code execution 會回 400 拒絕）——本中繼共用同一個上游工作區，開放檔案／容器類 API 會有跨使用者存取風險。

串流

Chat Completions、Responses、Anthropic Messages 與 Gemini streamGenerateContent 皆支援串流。送出 "stream": true（或改用串流端點），並以 Server-Sent Events（data: {JSON} 行）讀取回應。使用 curl 時加上 -N（--no-buffer）即可即時看到輸出。

計費與回應標頭

用量以帳號點數計費。非串流中繼回應會帶 X-Cost-Points（本次扣點）與 X-Credits-Remaining（扣點後餘額）標頭。串流回應無法附帶這些標頭；改為在最後一個事件（例如 data: [DONE]）之後，於串流結尾以 SSE 註解行帶出相同資訊：

: cost=12
: credits-remaining=34567

註解行（以 : 開頭）會被符合規範的 SSE 解析器與官方 SDK 忽略，完全不影響相容性；需要逐次帳務時可自行從原始串流讀取。也可以隨時查詢 GET /ntl/api/user/get_credits。呼叫失敗、或 vendor 未回傳用量資訊時，一律不收費。

錯誤處理

HTTP 狀態碼	意義
`401`	缺少或無效的 API 金鑰。同一 IP 重複失敗會被限流。
`402`	點數不足（`Insufficient credits. Please top up!`／`You need to top up!`）。
`400` + `No pricing info! Please use other models!`	要求的模型不在本中繼支援清單內——請呼叫 `/models` 端點取得可用清單。
`400`	請求內容格式錯誤，或要求了不支援的託管／伺服器端工具。
`502`	上游 vendor 錯誤——一律不收費。

說明文件

OpenAI ChatGPT API 說明 — Chat Completions／Responses／音訊／圖片中繼、請求參數、錯誤與串流。
Anthropic Claude API 說明 — Messages 中繼、請求參數、錯誤與串流。
Google Gemini API 說明 — generateContent／streamGenerateContent／Veo／Lyria 中繼。
Google 搜尋／新聞 API 說明 — 關鍵字搜尋，回傳結構化 JSON 結果。
OpenRouter API 說明 — 多供應商 LLM 閘道中繼（Chat Completions 格式）。
API 收費 — 用量如何換算成帳號點數。
MYAI168 MCP（CLI）說明 — 以 API 金鑰讓 CLI／程式開發代理透過 MCP 連接本站。
MYAI168 MCP（網頁及應用程式）說明 — 以 OAuth 連接 Claude.ai 等 MCP 用戶端。

MCP 伺服器

本站已開通的每個對話模型，也同時以 MCP（Model Context Protocol）工具形式提供。請將 MCP 用戶端連線到：

https://<host>/ntl/mcp/

認證方式：Authorization: Bearer <API_KEY>（CLI／程式開發代理），或以 OAuth 2.1 登入（Claude.ai 等用戶端；Client ID／Secret 留空即可——伺服器支援動態用戶端註冊）。詳見上方文件清單的 MCP 說明。