API 레퍼런스

Synthorai는 HTTPS를 통해 멀티 프로토콜 REST API를 제공합니다. 동일한 base URL, 키, 청구로 세 가지 요청 형식 - - OpenAI Chat Completions, OpenAI Responses, Anthropic Messages - - 을 처리하며, 임베딩, 이미지, 오디오, 재정렬을 위한 보조 엔드포인트도 함께 제공합니다.

Base URL:  https://synthorai.io/v1

All endpoints require:
  Content-Type:  application/json
  Authorization: Bearer <your-api-key>
  (or x-api-key: <your-api-key> for /v1/messages)

엔드포인트

엔드포인트	유형	설명
`POST /v1/chat/completions`	`chat`	OpenAI Chat Completions - - 범용 진입점으로, 모든 공급자로 라우팅합니다.
`POST /v1/responses`	`chat`	OpenAI Responses - - 도구 사용, 추론, 구조화된 출력.
`POST /v1/messages`	`chat`	Anthropic Messages - - Claude / Bedrock-Anthropic 네이티브.
`POST /v1/embeddings`	`embedding`	벡터 임베딩을 생성합니다.
`POST /v1/images/generations`	`image`	텍스트 프롬프트로부터 이미지를 생성합니다.
`POST /v1/videos`	`video`	비동기 동영상 생성 작업을 만들고 폴링합니다.
`POST /v1/audio/transcriptions`	`audio`	오디오를 텍스트로 전사합니다.
`POST /v1/audio/speech`	`audio`	텍스트를 음성으로 변환합니다.
`GET /v1/models`	`read`	인증된 키로 사용 가능한 모든 모델을 나열합니다.
`/api/v1/keys`	`keys`	코드에서 추론 키를 생성, 조회, 변경, 교체, 삭제합니다(keys.read 또는 keys.write 스코프가 있는 관리 키 필요).
`GET /api/v1/requests`	`logs`	워크스페이스의 요청을 조회합니다. 모델, 키, 토큰, 비용, 소요 시간, 레이블을 반환하며 프롬프트와 응답은 반환하지 않습니다(logs.read 스코프가 있는 관리 키 필요).
`/api/v1/prompts`	`prompts`	코드에서 프롬프트 라이브러리를 읽고 변경합니다. 프롬프트, 버전, 레이블, 점진적 배포와 테스트 세트, 평가 실행을 다룹니다(prompts.read 또는 prompts.write 스코프가 있는 관리 키 필요, 테스트는 evals.read 또는 evals.write 필요).
`GET /api/v1/audit-logs`	`workspace`	워크스페이스의 설정과 변경 내역을 읽습니다. 감사 로그, 멤버와 초대, BYOK 설정, 내보내기 대상이 있으며 각각 전용 읽기 스코프가 있습니다. 자격 증명은 어떤 것도 반환하지 않습니다.
`GET /api/v1/billing/*`	`billing`	자신의 워크스페이스에 대한 읽기 전용 사용량, 비용, 데이터 신선도 정보입니다 (일반 API 키가 아닌 빌링 키가 필요합니다).
`POST /v1/mcp`	`mcp`	MCP 서버: 모든 모델, API 키 관리, 빌링 데이터를 AI 에이전트(Claude Code, Cursor, Codex 등)용 도구로 제공하며 API 키만 있으면 됩니다.

모든 엔드포인트는 동일한 토큰당 가격표로 청구됩니다. 라우팅 가능한 각 모델의 비용은 model price comparison에서 확인하세요.