빠른 시작
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 호환 도구에 연결하는 경우——주요 세 가지 도구에는 각각 전용 설정 페이지가 있으며, 나머지 모든 도구를 위한 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에서 라우팅 가능한 각 모델의 토큰당 가격을 나란히 비교해 보세요.