ujG0 dUdZddlZddlZddlZddlZddlZddlZddlm Z m Z m Z ddl m Z ddlmZdZdZdd d d id d id d idd d iddgddZe ee fed<dZdedefdZeddddddededed ede ee ff d!Zd"e ee fdefd#ZGd$d%Zdefd&Zdd'd(Zdefd)Zy)*u이미지 품질 검증 모듈 — GPT-5.4 비전으로 생성된 이미지 품질 판정. prompt_loader 통합 (problems.md #14): hard-coded ``v1`` 디렉토리 직접 read 제거 → ``prompt_loader.load_prompt`` 경유 (DB 우선 + numeric version 정렬 + #6 #13). N)AnyDictList)settings) traced_callimage_validationz#https://api.openai.com/v1/responsesobjectFtypestringintegerbooleanarray)r items) descriptionscorepassedissues)r additionalProperties propertiesrequiredVALIDATION_SCHEMA<filenamereturncXddlm}|jdr|ddn|}|t|S)uV``prompts/_base/image_validation`` 에서 stem 로드 (DB 우선). 파일 모듈 이름은 ``image_validator`` (단수) 이지만 prompts 디렉토리는 ``image_validation`` (다른 형태) — 흡수 시 매핑 confusion 회피 (review I4). Raises FileNotFoundError 또는 RuntimeError (#6 strict mode) — caller 처리. r) load_promptz.mdN)app.modules.prompt_loaderrendswith_MODULE)rrstems Q/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/image_validator.py _load_promptr#(s.6$--e48CR=(D w %%vision_validationopenaic|SN)api_keymodelaks r"r.7ser$c|Sr(r))r*r+ image_bytes text_promptr,r-s r"r.r.8s!r$z[vision judged]) operationprovidermodel_of prompt_of output_textr*r+r0r1ctj|jd}|ddd|ddd|dgd gd d d d tdiddd}tj j ttj|jdd|ddd}tj}tj}d} td|dzD]`} tj j||5} tj | j#jd} dddnt)d'|  j=d(}t?|t@r%|jCrtj |S| j=d)}t?|tDr|D]}t?|tFs|j=d*}t?|tDs6|D]s}t?|tFs|j=d+d(k(s)|j=d,}t?|t@sK|jCs\tj |ccSt)d-#1swY?xYw#tj$j&$r} | j#jdd}t)d| j*d|} d d!lm}|| | j*|"d d#lm}| j*d$vr+| |kr&|| st3j4d| zYd} ~ U| | d} ~ wtj$j6t8j:f$r<} | } | |krt3j4d| zYd} ~ t)d%|d&| | d} ~ wwxYw).uCall OpenAI Responses API with image input for vision analysis. ★기록: 이 경로는 urllib 로 Responses API 를 직접 쳐서 litellm 콜백이 안 닿는다 — 감싸지 않으면 VLM 판정이 Opik 에 한 줄도 안 남는다(2026-08-07). asciimessageuser input_text)r text input_imagezdata:image/png;base64,)r image_url)r rolecontentformat json_schemarT)r namestrictschemag?F)r+inputr< temperaturestorezutf-8zBearer zapplication/json) Authorizationz Content-TypePOST)dataheadersmethodN)timeoutreplace)errorszOpenAI Vision API error z: r)mark_openai_failure)statusbody)is_key_level_failure>zOpenAI Vision API failed after z retries: zOpenAI Vision API failed: r6outputr@r r<z3OpenAI Vision response did not include output_text.)$base64 b64encodedecoderurllibrequestRequestOPENAI_API_URLjsondumpsencoderllm_timeout_validationllm_max_retriesrangeurlopenloadsreaderror HTTPError RuntimeErrorcodeapp.core.openai_keysrSrVtimesleepURLErrorsocketrPget isinstancestrstriplistdict)r*r+r0r1b64_datarUreqrP max_retries last_errorattemptresppayloadexc error_textrSrVr6r\itemr@partr<s r"_call_openai_visionr6sF  ,33G  -<7 |DEE++m,K+s# (9(9(;zz+&& [[ "F&$DdD)hhy)Ggt,dD)dhhv.>-.O88F+D!$,#zz$//   L MMc>=||%% &**79*EJ%(@ "ZL&YZJ A 388* > B55;.0< 1w;'# % %%v~~6 hJ+% 1w;'!@ ZX[W\]^dg g  hsI !I*-3I I*I' "I**N BL L  0N N5NN  entity_infoc|jdd}t|tr tj|}n|}|jdg}|sJt|t r:|jD]'\}}t|ts|j|)|sydjd|DS#tj $ri}YwxYw)z+Format stable traits into a readable block. stable_traitsz{}visual_anchor_traitsz- (no specific traits listed) c3&K|] }d| yw)z- Nr)).0traits r" z'_format_traits_block..s=}er%\}s) rvrwrxrdrkJSONDecodeErrorr{rappendjoin)rr traits_data visual_traits_kvs r"_format_traits_blockrsOOOT:M-% **]3K$ OO$:B?M Z T: &&(EB!S!$$Q') . 99=}= ==## K sB55C  C c eZdZdZ ddedzdedzddfdZdedeeefdeeeffd Z ded eeefd e edeeeffd Z d edeeefdeeeffdZ y)ImageValidatoru7GPT-5.4 비전으로 생성된 이미지 품질 판정.Nr*r+rcD||_|xstj|_yr() _explicit_keyr openai_model_model)selfr*r+s r"__init__zImageValidator.__init__s%4x44 r$r0rc ~ts tdtd}|j|j dd|j dd|j ddt ||j dd t fd j }|j d d }|tk\|d<|S)uI참조 이미지가 엔티티 설명과 일치하는지 검증. Args: image_bytes: PNG image bytes to validate. entity_info: Dict with keys: name, entity_type, description, stable_traits. Returns: {"score": 0-100, "passed": bool, "issues": [...], "description": str} 6OpenAI API key is not configured for image validation.zreference_validation.mdrC entity_typer world_context Not provided) entity_namerr traits_blockrc6t|jSN)r*r+r0r1rrrr0promptrs r"r.z9ImageValidator.validate_reference_image..*kk'" r$ fixed_keyrrr) _has_openai_keyror#rArvr_with_key_failoverrPASS_THRESHOLD)rr0rtemplateresultrrs`` @r"validate_reference_imagez'ImageValidator.validate_reference_images WX X 9:#3# r:# r:-k:%///>J ! $  ((  7A& N2x r$ scene_info entity_namesc ts tdtd}|j|j dd|j dd|j dd|rdj |nd|j d d  t fd j }|j dd}|tk\|d<|S)u씬 이미지가 프롬프트 및 엔티티와 일치하는지 검증. Args: image_bytes: PNG image bytes to validate. scene_info: Dict with keys: scene_heading, beat_title, still_frame_prompt. entity_names: List of entity names expected to be visible. Returns: {"score": 0-100, "passed": bool, "issues": [...], "description": str} rzscene_validation.md scene_headingr beat_titlestill_frame_promptz, z(none)rr)rr scene_promptrrc6t|jSrrrs r"r.z5ImageValidator.validate_scene_image..rr$rrrr) rror#rArvrrrr)rr0rrrrrrs`` @r"validate_scene_imagez#ImageValidator.validate_scene_images  WX X 56$.."=!~~lB7#(.6s*kk*" r$rrrr) rror#rArvrxrrr)rrrrrrrs`` @r"validate_pdf_pagez ImageValidator.validate_pdf_pages WX X 34(,,]IF*..{EBC)--j$?@*..C ! $  ((  7A& N2x r$)NN) __name__ __module__ __qualname____doc__rxrbytesrrrrrrr)r$r"rrsA# 5t5Tz5  5''#s(^' c3h 'R((cN(3i ( c3h (T%%sCx.% c3h %r$rcddlm}|S)Nrhas_openai_key)rqrrs r"rrCs3  r$rc$ddlm}||d|S)uU활성 슬롯 키로 부르고 키 수준 실패면 다음 슬롯으로 (2026-08-01).r)call_with_key_failoverzimage_validator.vision)wherer)rqr)fnrrs r"rrIs; ! *i AAr$cddlm}|S)uO활성 키 슬롯 — 1차 필드를 직접 보면 보조 키가 안 쓰인다.r active_key)rqrrs r"_active_openai_keyrQs / <r$)rr]rdrurr urllib.errorr`urllib.requesttypingrrrapp.core.configrapp.modules.llm.image_tracerrr rcrrx__annotations__rr#rrrrboolrrrr)r$r"rsX  ""$4 6 !))$9%h' = %4S>  &3 &3 & *X;"* , hN hN hNhN hN  #s(^ hN , hNV>d38n>>,EEN )-ACr$