🎁 新人 免费注册,送 10 次调用,最高 $1,免绑卡。

快速开始

在 2 分钟内开始使用 Synthorai。

1. 获取你的 API Key

登录并前往 Console → API Keys. 点击 "创建密钥" 并立即复制——它只会显示一次。

2. 发起你的第一个请求

选择你已经在用的 SDK。两种示例都使用同一个 API key 访问同一个 gateway。

方案 A —— OpenAI SDK

curl https://synthorai.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "Hello! What can you do?"}
    ]
  }'

方案 B —— Anthropic SDK

curl https://synthorai.io/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "Hello! What can you do?"}
    ]
  }'

Anthropic SDK 会在内部追加 /v1/messages 。请使用 gateway origin(不带 /v1 后缀)作为 base_url ——这与接受 https://synthorai.io/v1.

3. 列出可用模型

curl https://synthorai.io/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

模型 ID 遵循原始提供商使用的格式。你可以通过以下方式发现完整列表: /v1/models 端点,或访问 模型目录 页面。

使用工具而非原始 SDK?

如果你要将 Synthorai 接入 Claude Code、OpenAI Codex CLI、OpenClaw、Cursor、Continue、Aider 或任何其他 OpenAI/Anthropic 兼容的工具——我们为三大主流工具各提供了专门的设置页面,并为其余工具提供了一份 base URL 速查表。

认证

所有 API 请求都需要在以下位置传入 API 密钥: Authorization 请求头中传入。

Bearer Token

Authorization: Bearer YOUR_API_KEY

密钥权限范围

参数类型说明
Readstring仅可访问模型列表和用量数据。
Writestring发起推理请求(chat、completions)。
Adminstring完全访问权限,包括通道和用户管理。

切勿在客户端代码或公共仓库中暴露你的 API 密钥。如果密钥泄露,请立即通过以下位置轮换: Console → API 密钥.

密钥格式

Synthorai 密钥以以下前缀开头: sk- 后跟一个随机的 32 字符字符串。密钥在存储时经过哈希处理,创建后无法恢复。

不确定从哪个模型开始?浏览 model price comparison 即可并排查看每个可路由模型的按 token 价格。