프로토콜 변환
모든 엔드포인트에서 모든 모델을 사용하는 방법과 그대로 전달되는 항목, 변환할 수 없는 몇 가지 항목을 설명합니다.
모든 엔드포인트에서 모든 모델을 사용할 수 있습니다. /v1/responses를 통해
Claude 모델을 요청하거나 /v1/messages를 통해 GPT 모델을 요청해도 지원됩니다.
덕분에 한 프로토콜을 사용하는 클라이언트가 두 번째 게이트웨이를 실행하지 않고도 다른 프로토콜을 사용하는 공급업체의 모델을 이용할 수 있습니다.
| 엔드포인트 | 프로토콜 | 일반적인 클라이언트 |
|---|---|---|
/v1/chat/completions |
OpenAI 채팅 완성 | OpenAI SDK, OpenClaw, Hermes, 대부분의 편집기 |
/v1/messages |
Anthropic Messages | Anthropic SDK, Claude Code |
/v1/responses |
OpenAI Responses | Codex, 최신 OpenAI SDK |
클라이언트마다 전송하는 방식이 다르므로 자격 증명은 Authorization: Bearer,
x-api-key 또는 api-key 형식으로 사용할 수 있습니다.
아무것도 변환하지 않는 경우
엔드포인트와 모델 공급업체가 이미 같은 프로토콜을 사용한다면 요청 본문을 다시 구성하지 않고 그대로 전달합니다. 모델 ID만 다시 작성합니다.
캐시 중단점, 추론 서명, Webway가 알지 못하는 필드는 모두 변경 없이 공급업체에 전달됩니다. 이 페이지가 작성된 후 출시된 공급업체 기능도 출시 당일부터 작동합니다.
변환할 수 없는 항목
이 경로를 벗어나면 일부 항목은 대상 프로토콜에서 옮길 곳이 없습니다.
- 캐시 중단점은 대상이 채팅 완성인 경우 삭제됩니다. 채팅 완성에는
cache_control이 없습니다. 해당 공급업체는 암시적으로 캐시하므로 비용이 아니라 제어 능력이 줄어듭니다. - 추론 서명은 사고 블록이 수정되지 않은 채 반환되었다는 공급업체의 증명입니다. 이를 발급한 공급업체에만 적용되며 다른 공급업체의 프로토콜로 옮길 수 없으므로 위조하는 대신 삭제합니다.
- **
previous_response_id**는400응답과 함께 거부됩니다. Webway는 대화 상태를 저장하지 않습니다. 전체input배열을 전송하세요. 이 필드를 무시하면 대화 기록이 아무런 경고 없이 삭제됩니다.
도구, 도구 결과, 이미지, 시스템 프롬프트, 종료 사유, 스트리밍 순서와 토큰 수는 양방향 변환에서 모두 유지됩니다.
토큰 수
공급업체가 이 기능을 제공하지 않는 모델을 포함해 모든 모델에서
/v1/messages/count_tokens를 사용할 수 있으므로 Claude Code의 컨텍스트
측정기가 어디서나 작동합니다. 이러한 모델의 토큰 수는 추정치입니다.
캐시된 입력에는 캐시 요율이 적용되고 캐시 쓰기에는 쓰기 요율이 적용됩니다.
사용량은 청구서에 반영되기 전에 정규화됩니다. Anthropic은 캐시된 토큰을
input_tokens에서 제외하고 OpenAI는 이를 prompt_tokens에 포함하며,
GET /v1/models는 각 요율을 별도로 제공합니다.