OpenAI-Compatible API Contract

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

주요 현재 동작:

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 Pi coding agent 설정 가이드는 dev-corp-pi-settings-guide.md를 기준으로 한다.

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