クイックスタート
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?"}
]
}'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 ——次を受け取る OpenAI SDK とは異なります 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 互換ツールに接続する場合——主要な 3 つのツールにはそれぞれ専用のセットアップページがあり、その他すべてには base URL のチートシートを用意しています。
認証
すべての 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 で各ルーティング可能モデルのトークン単価を並べて確認できます。