iop/docs/openai-compatible-api-contract.md
2026-07-13 11:45:56 +09:00

1.5 KiB

OpenAI-Compatible API Contract

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

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

주요 현재 동작:

  • Chat Completions provider route의 기본 응답 mode는 provider-original passthrough다.
  • provider-pool model group route는 caller가 metadata.iop_response_mode를 명시하면 값과 무관하게 거부하고, 생략 시 provider-original passthrough로 동작한다.
  • direct legacy provider route는 passthrough+sideband extension selector를 지원한다. passthrough+sidebandtransformed는 IOP 확장/변환 응답이며 provider-original byte identity로 취급하지 않는다.
  • dev-corp gemma4:26b provider-pool에서 think/stream/include_reasoning 요청 파라미터만 바꿔 측정하는 범위는 계약 원문의 dev-corp gemma4:26b 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의 라우팅 규칙을 먼저 따른다.