クイックスタート
From signing in to a working integration. Each step takes a minute or two, and you can stop after step 3 if all you need is one call.
What you are about to do - Get a key, prove it works without writing code, wire it into your app, then keep it topped up. Where a welcome campaign is running you can do the first calls on free credit; otherwise a small top-up comes first.
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. Try it without writing code
Open the Playground in the console, pick a model and send a prompt. It runs through the same pipeline as your API traffic, so a reply confirms the model and your balance. It authenticates with your console session rather than an API key, so test the key itself with the request above.
4. 利用可能なモデルを一覧表示する
curl https://synthorai.io/v1/models \
-H "Authorization: Bearer YOUR_API_KEY" モデル ID は元のプロバイダーが使用する形式に従います。完全なリストは次の方法で確認できます /v1/models エンドポイント、または次のページを参照してください モデルカタログ ページ。
5. Wire it into your app
Point your existing client at the gateway: change the base URL and use your Synthorai key. Your model ids, request shapes and SDKs stay as they are. From there the capability guides cover the things that change your bill - caching a repeated prefix, or capping how much a model thinks.
Using Claude Code, Codex CLI or OpenClaw instead of an SDK? Those have their own one-line setup:
6. Add credit when you need it
Usage draws down a prepaid balance - no monthly platform fee, no subscription. Top up from Billing with a card or crypto; the balance is usable the moment it lands. Free credit comes from a welcome campaign where one is running, not automatically on signup.
Where to go next
- Prompt caching - bill a repeated prefix at a fraction of its normal price
- Reasoning effort - the biggest cost lever on models that reason by default
- API keys - quotas, model allowlists, expiry and rotation
- Usage analytics - where the spend actually went
認証
すべての 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 で各ルーティング可能モデルのトークン単価を並べて確認できます。