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 了解每个可路由模型的费用。