API 레퍼런스
OpenAI 호환 completions, dry-run 헬퍼, 그리고 필드 스키마 조회.
OpenAI 호환 completions 엔드포인트, dry-run 헬퍼, 그리고 필드 스키마 조회. 요청 본문에 policy_ir 또는 flow_ir를 포함하세요. 추론은 호스트에 구성된 제공자 키를 통해 실행됩니다.
인증
모든 요청에는 Authorization: Bearer <key>가 필요합니다. 호스트 키는 워크스페이스와 트레이스 기록을 식별하며, 제공자 계정을 나타내지 않습니다. 제공자 키(OpenAI, Anthropic, Gemini 등)는 호스트에 구성됩니다. unhardcoded는 직접 보유한 계정을 통해 라우팅하며, 토큰을 재판매하거나 추론 비용에 마진을 붙이거나 모델 사용료를 청구하지 않습니다.
엔드포인트
POST/v1/chat/completions
OpenAI 호환 completions. 본문에
policy_ir 또는 flow_ir를 포함하세요. 나머지는 표준 요청 형식과 동일합니다. 라우터는 실시간 카탈로그에서 모델을 결정하고 트레이스에 결정 내용을 기록합니다.POST/x/rankdry-run
추론을 실행하지 않고 후보 순위와 모델별 판정 결과를 반환합니다. 토큰을 사용하기 전에 어떤 모델이 기준을 통과하는지, 그리고 그 이유를 미리 확인할 수 있습니다.
POST/x/policy/normalizedry-run
policy_ir를 받아 정규화된 형식, 콘텐츠 fingerprint, 그리고 문법 version을 반환합니다. 실행하지 않고도 term을 식별하고 캐시할 수 있습니다.POST/x/flow/normalizedry-run
flow_ir를 받아 식별합니다. 유계 그래프와 각 노드의 정책을 검증하므로, 잘못된 워크플로우가 실행 중간이 아닌 시작 단계에서 바로 실패합니다.GET/x/fields
실시간 필드 어휘를 반환합니다. 코어 필드와 해당 호스트에 등록된 확장 필드로 구성되며, 정책이
cmp/is로 필터링하고 field로 점수를 매기는 대상입니다. 유효한 필드 이름의 정보 원천입니다.요청 본문
policy_ir(또는 flow_ir)는 model 및 messages와 같은 최상위 레벨에 위치합니다. 둘 다 있을 경우 flow_ir가 우선합니다. 정책 또는 플로우를 첨부하면 라우팅이 그에 따라 결정되고, model은 트레이스 레이블로만 사용됩니다. 둘 다 없을 경우, model 문자열이 라우트를 선택합니다(예: profile:cheap 또는 flow:<id>). 없으면 호스트의 기본 프로파일로 폴백합니다.
$ curl https://<your-host>/v1/chat/completions \
-H "Authorization: Bearer $UNHARDCODED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "policy:support",
"messages": [{ "role": "user", "content": "…" }],
"policy_ir": ["policy", ["and", ["meets_req"]], …]
}'