快速开始
从登录到接进你的应用。每步一两分钟;如果你只需要调一次,做完第 3 步就可以停。
接下来要做的事 - 拿到密钥、不写代码先验证能用、接进应用,然后保持余额充足。有欢迎活动进行时,前几次调用可以用免费额度;否则需要先小额充值。
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?"}
]
}'from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://synthorai.io/v1"
)
response = client.chat.completions.create(
model="gpt-5.4-mini",
messages=[{"role": "user", "content": "Hello! What can you do?"}]
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: "YOUR_API_KEY",
baseURL: "https://synthorai.io/v1",
});
const response = await client.chat.completions.create({
model: "gpt-5.4-mini",
messages: [{ role: "user", content: "Hello! What can you do?" }],
});
console.log(response.choices[0].message.content);方案 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?"}
]
}'from anthropic import Anthropic
client = Anthropic(
api_key="YOUR_API_KEY",
base_url="https://synthorai.io"
)
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=256,
messages=[{"role": "user", "content": "Hello! What can you do?"}]
)
print(message.content[0].text)import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: "YOUR_API_KEY",
baseURL: "https://synthorai.io",
});
const message = await client.messages.create({
model: "claude-sonnet-4-6",
max_tokens: 256,
messages: [{ role: "user", content: "Hello! What can you do?" }],
});
console.log(message.content[0].text);Anthropic SDK 会在内部追加 /v1/messages 。请使用 gateway origin(不带 /v1 后缀)作为 base_url ——这与接受 https://synthorai.io/v1.
3. 不写代码先试一次
在控制台打开 Playground,选一个模型发一条 prompt。它走的是和 API 流量相同的链路,所以能回复就说明模型和余额都没问题。它用控制台会话鉴权而不是 API 密钥,所以密钥本身要用上面那个请求来验。
4. 列出可用模型
curl https://synthorai.io/v1/models \
-H "Authorization: Bearer YOUR_API_KEY" 模型 ID 遵循原始提供商使用的格式。你可以通过以下方式发现完整列表: /v1/models 端点,或访问 模型目录 页面。
5. 接进你的应用
把现有客户端指向网关:改 base URL、换成你的 Synthorai 密钥。模型 ID、请求结构和 SDK 都不用动。之后可以看能力指南里真正影响账单的两件事——缓存重复前缀,以及限制模型的思考量。
用的是 Claude Code、Codex CLI 或 OpenClaw 而不是 SDK?它们各有一行配置的接法:
6. 需要时再充值
用量从预付余额里扣——没有月费,也没有订阅。在 Billing 用银行卡或加密货币充值,到账即可用。免费额度来自正在进行的欢迎活动,不是注册就自动发放。
接下来看什么
- Prompt caching —— 让重复前缀按远低于正常价的费率计费
- 推理强度 —— 默认无界推理的模型上最大的成本杠杆
- API 密钥 —— 额度、模型白名单、有效期与轮换
- 用量分析 —— 钱到底花在哪
认证
所有 API 请求都需要在以下位置传入 API 密钥: Authorization 请求头中传入。
Bearer Token
Authorization: Bearer YOUR_API_KEY 密钥权限范围
| 参数 | 类型 | 说明 |
|---|---|---|
Read | string | 仅可访问模型列表和用量数据。 |
Write | string | 发起推理请求(chat、completions)。 |
Admin | string | 完全访问权限,包括通道和用户管理。 |
切勿在客户端代码或公共仓库中暴露你的 API 密钥。如果密钥泄露,请立即通过以下位置轮换: Console → API 密钥.
密钥格式
Synthorai 密钥以以下前缀开头: sk- 后跟一个随机的 32 字符字符串。密钥在存储时经过哈希处理,创建后无法恢复。
不确定从哪个模型开始?浏览 model price comparison 即可并排查看每个可路由模型的按 token 价格。