# OpenAI-Compatible API Contract

계약 원문은 [agent-contract/outer/openai-compatible-api.md](../agent-contract/outer/openai-compatible-api.md)다.

이 문서는 사람용 안내와 기존 링크 유지를 위한 포인터다. 요청 스키마, 필드 의미, 금지 사항, 구현 메모는 계약 원문을 기준으로 한다.

주요 현재 동작:

- Chat Completions provider route의 기본 응답 mode는 provider-original `passthrough`다.
- caller는 `metadata.iop_response_mode`에 `passthrough`, `passthrough+sideband`, `transformed` 중 하나를 넣어 응답 경로를 선택할 수 있다.
- `passthrough+sideband`와 `transformed`는 IOP 확장/변환 응답이며 provider-original byte identity로 취급하지 않는다.

에이전트 작업에서는 [agent-contract/index.md](../agent-contract/index.md)의 라우팅 규칙을 먼저 따른다.