# OpenAI-Compatible API Contract

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

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

주요 현재 동작:

- IOP OpenAI-compatible 표면의 기본 베이스는 OpenAI-compatible request/response surface 보존이다. Provider-pool passthrough는 selected provider가 지원하는 표준 field와 provider extension field를 IOP allowlist로 제한하지 않는다.
- `think`, `reasoning_effort`, `thinking_token_budget`, `include_reasoning` 같은 IOP field는 OpenAI-compatible 기본 surface 위의 확장이다. Provider-native field를 대체하거나 금지하는 수단으로 해석하지 않는다.
- 라우팅의 1차 기준은 request `model`이 가리키는 provider capability다. OpenAI-compatible provider이면 provider-original `passthrough`, 그 외 CLI/Ollama/native 실행이면 normalized path를 사용한다.
- `metadata`는 route/response selector가 아니다. Edge는 모델 기반 route 선택 뒤 IOP가 아는 metadata key만 workspace, task, principal, usage/observability 문맥으로 발췌한다.
- dev-corp provider-pool에서 기본 smoke 파라미터와 provider-native field passthrough 기대 동작은 계약 원문의 provider-pool passthrough 섹션을 기준으로 한다.
- dev-corp Ollama `gemma4:26b` 이미지 입력 호출 가이드는 [dev-corp-ollama-gemma4-image-call-guide.md](./dev-corp-ollama-gemma4-image-call-guide.md)를 기준으로 한다.
- dev-corp Pi coding agent 설정 가이드는 [dev-corp-pi-settings-guide.md](./dev-corp-pi-settings-guide.md)를 기준으로 한다.

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