빠른 시작
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에서 라우팅 가능한 각 모델의 토큰당 가격을 나란히 비교해 보세요.