API 參考

Synthorai 透過 HTTPS 提供多協定 REST API。同一個 base URL、金鑰與計費可服務三種請求形態 —— OpenAI Chat Completions、OpenAI Responses 與 Anthropic Messages —— 此外還有用於嵌入、圖片、音訊與重新排序的輔助端點。

Base URL:  https://synthorai.io/v1

All endpoints require:
  Content-Type:  application/json
  Authorization: Bearer <your-api-key>
  (or x-api-key: <your-api-key> for /v1/messages)

端點

端點	類型	說明
`POST /v1/chat/completions`	`chat`	OpenAI Chat Completions —— 通用進入點，可路由至任意供應商。
`POST /v1/responses`	`chat`	OpenAI Responses —— 工具呼叫、推理、結構化輸出。
`POST /v1/messages`	`chat`	Anthropic Messages —— Claude / Bedrock-Anthropic 原生格式。
`POST /v1/embeddings`	`embedding`	產生向量嵌入。
`POST /v1/images/generations`	`image`	根據文字提示產生圖片。
`POST /v1/videos`	`video`	建立並輪詢非同步影片生成任務。
`POST /v1/audio/transcriptions`	`audio`	將音訊轉錄為文字。
`POST /v1/audio/speech`	`audio`	將文字轉換為語音。
`GET /v1/models`	`read`	列出該已驗證金鑰可用的所有模型。
`/api/v1/keys`	`keys`	用自己的程式碼建立、列出、修改、輪換和刪除推論金鑰（需要帶 keys.read 或 keys.write 的管理金鑰）。
`GET /api/v1/requests`	`logs`	列出並讀取工作區的請求：模型、金鑰、token、費用、耗時和標籤，不包含提示詞和回答（需要帶 logs.read 的管理金鑰）。
`/api/v1/prompts`	`prompts`	用自己的程式碼讀取和修改提示詞庫：提示詞、版本、標籤和漸進式發布，以及測試集和評測執行（需要帶 prompts.read 或 prompts.write 的管理金鑰；測試部分需要 evals.read 或 evals.write）。
`GET /api/v1/audit-logs`	`workspace`	讀取工作區的設定和變更紀錄：稽核日誌、成員與邀請、BYOK 設定、匯出目的地，各有獨立的唯讀權限範圍。不會回傳任何憑證。
`GET /api/v1/billing/*`	`billing`	唯讀的用量、費用與資料新鮮度資訊，面向你自己的工作區（需要帳單金鑰，而非一般 API 金鑰）。
`POST /v1/mcp`	`mcp`	MCP 伺服器：將所有模型、API 金鑰管理與帳單資料作為工具提供給 AI agent（Claude Code、Cursor、Codex……），使用你的 API 金鑰即可。

每個端點都基於同一份按 token 計費的價目表——查看 model price comparison 了解每個可路由模型的費用。