프로토콜

Synthorai는 동일한 base URL에서 세 가지 입력 프로토콜을 제공합니다. SDK에 맞는 것을 선택하세요. 게이트웨이가 업스트림 공급자로의 프로토콜 변환을 투명하게 처리합니다.

프로토콜 매트릭스

엔드포인트	SDK	적합한 용도
`POST /v1/chat/completions`	OpenAI SDK	범용 — 모든 공급자에서 작동합니다. e.g. `gpt-5.4-mini, qwen3.5-flash, gemini-2.5-flash, claude-sonnet-4-6`
`POST /v1/responses`	OpenAI SDK (Responses)	도구 사용, 추론, 구조화된 출력. e.g. `gpt-5.4, gpt-5.4-mini, gpt-5.3-codex`
`POST /v1/messages`	Anthropic SDK	Anthropic 또는 Bedrock 채널을 통한 Claude 네이티브 워크플로. e.g. `claude-sonnet-4-6, claude-opus-4-1`

어떤 것을 사용해야 하나요?

이미 OpenAI SDK를 사용하고 계신가요? 계속 사용하면 됩니다. /v1/chat/completions 은(는) 범용 경로이며 구성된 모든 공급자로 라우팅됩니다.
이미 Anthropic SDK를 사용하고 계신가요? 해당 baseURL 을(를) 게이트웨이로 가리키고 다음을 호출하세요: /v1/messages. Anthropic 또는 Bedrock-Anthropic 채널로 라우팅됩니다.
OpenAI 모델에서 도구 사용, 추론 또는 구조화된 출력이 필요하신가요? 다음을 사용하세요: /v1/responses.

ℹ

세 가지 프로토콜은 모두 동일한 API key, 속도 제한, 청구 및 할당량을 공유합니다. 유일한 차이점은 요청/응답 형태이며 게이트웨이가 내부적으로 모든 것을 정규화합니다.

보조 엔드포인트

세 가지 채팅 프로토콜 외에도 게이트웨이는 다음 OpenAI 호환 엔드포인트도 프록시합니다:

매개변수	유형	설명
`POST /v1/embeddings`	`embedding`	텍스트에 대한 벡터 임베딩(embeddings)을 생성합니다.
`POST /v1/images/generations`	`image`	텍스트 프롬프트에서 이미지를 생성합니다.
`POST /v1/audio/transcriptions`	`audio`	오디오를 텍스트로 전사합니다(multipart/form-data).
`POST /v1/audio/speech`	`audio`	텍스트를 음성 오디오로 변환합니다.
`POST /v1/rerank`	`rerank`	쿼리에 대해 문서를 재정렬합니다.

스트리밍

Server-Sent Events (SSE)를 사용하여 응답 token이 생성되는 대로 받습니다.

스트리밍 활성화

다음을 설정하세요 "stream": true 요청 본문에 설정합니다. 응답은 다음 이벤트의 스트림이 됩니다 data: 이벤트.

curl https://synthorai.io/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "stream": true,
    "messages": [{"role": "user", "content": "Count to 5"}]
  }'

SSE 응답 형식

data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"1"},"index":0}]}
data: {"id":"chatcmpl-...","choices":[{"delta":{"content":","}}]}
data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"2"}}]}
data: [DONE]

ℹ

스트림은 다음으로 종료됩니다 data: [DONE] 이벤트. 다음으로 시작하는 각 줄을 파싱합니다 data: 그리고 다음을 추출합니다 choices[0].delta.content 필드.

이 모든 모델과 각 토큰당 가격은 model price comparison 페이지에 나와 있습니다.