자주 묻는 질문

Synthorai에 대한 자주 묻는 질문.

Synthorai는 어떤 SDK를 지원하나요?

OpenAI SDK(/v1/chat/completions 및 /v1/responses 경유)와 Anthropic SDK(/v1/messages 경유)입니다. baseURL/base_url을 게이트웨이로 설정하고 게이트웨이 API key를 사용하세요 — 다른 코드 변경은 필요 없습니다.

도구에 어떤 base URL을 붙여넣어야 하나요?

두 가지 규칙으로 정리됩니다. OpenAI 스타일 도구(Codex, Cursor, Continue, Aider, LangChain ChatOpenAI, 원시 OpenAI SDK)는 origin 뒤에 /v1을 붙인 형태를 요구합니다. Anthropic 스타일 도구(Claude Code, Anthropic SDK, LangChain ChatAnthropic)는 /v1 없는 origin을 요구합니다 — SDK가 /v1/messages를 직접 추가합니다. Tool Compatibility 페이지에 전체 표가 있습니다. 페이지 보기 →

환경 변수를 설정했는데도 도구가 여전히 원래 공급자에 연결됩니다. 무엇을 놓쳤나요?

새 환경 변수는 프로필을 편집한 이후에 연 shell에만 적용됩니다. 새 터미널을 열거나 현재 터미널에서 source ~/.zshrc / source ~/.bashrc를 실행하세요. echo $OPENAI_BASE_URL 또는 echo $ANTHROPIC_BASE_URL로 확인할 수 있습니다.

어떤 모델 이름을 사용할 수 있는지 어떻게 알 수 있나요?

curl https://synthorai.io/v1/models -H "Authorization: Bearer YOUR_KEY"를 실행하거나 Console → Model Pricing을 방문하세요. id 열의 값을 요청의 model 매개변수로 전달하면 게이트웨이가 라우팅을 자동으로 처리합니다.

Anthropic SDK를 Claude가 아닌 모델에 사용할 수 있나요?

아니요. /v1/messages는 구성된 Anthropic 또는 Bedrock-Anthropic 채널을 통해 Claude 모델로만 라우팅합니다. 다른 공급자의 경우 /v1/chat/completions를 사용하세요. 라우팅되는 모든 모델에서 동작합니다.

새 프로젝트에는 어떤 프로토콜을 선택해야 하나요?

최대 호환성을 위해서는 /v1/chat/completions를 사용하세요 — 모든 공급자에서 동작합니다. OpenAI 도구 사용 및 추론에는 /v1/responses를 사용합니다. Anthropic SDK로 표준화하는 경우 /v1/messages를 사용하세요.

할당량이 소진되면 어떻게 되나요?

요청은 오류 유형 "quota_exceeded"와 함께 403 상태 코드를 반환합니다. Console → Limits & Billing에서 충전할 수 있습니다.

사용량은 어떻게 계산되나요?

사용량은 token 단위로 측정됩니다. 입력 token과 출력 token은 별도로 계산되며 각 API 응답의 usage 필드에 보고됩니다.

사용자별 할당량을 설정할 수 있나요?

예. 관리자는 Console → Members에서 사용자별 token 할당량을 구성할 수 있습니다.

요청이 기록되나요?

예. 모든 요청은 모델, token, 지연 시간, 상태와 함께 기록됩니다. 로그는 30일간 보관되며 Console → Logs에서 확인할 수 있습니다.

모델 간 지출을 비교하고 계신가요? model price comparison은(는) 라우팅 가능한 각 모델의 토큰당 가격을 나열하고, LLM API cost calculator은(는) 토큰 사용량을 월 청구 예상액으로 환산해 줍니다.