FjL UdZddlmZddlZddlZddlZddlmZddlm Z m Z m Z m Z m Z ddlmZddlmZej$eZdd d d Zd ed <dZddZGddeZy)ugpt-image-2.5 클라이언트 — nb2 gen_fn 슬롯·SAFETY 사다리 호환. 2026-09-20 사용자 결정: 최종 스틸 **조립**을 gpt-image-2.5 로 간다. 실측 근거 — nb2 가 두 판 이상 못 고치던 샷 8개를 같은 문안·같은 참조로 gpt-image-2.5 에 넘기니 **여덟 장 다 한 판**에 해결됐다 (`project-gpt25-direct-assembly-beats-nb2-rerolls`). ★왜 gen_fn 이 아니라 **클라이언트**인가. `gpt_image_gen.make_gpt_image_gen_fn` 이 이미 있지만 그것은 「연화 1회」뿐이다. 사용자가 지시한 검열 사다리는 **grok → seedream** 이고, 그 사다리(`multiroll_gemini.gen_fn_ladder`)는 **클라이언트**를 단계마다 갈아 끼우는 구조다. 그래서 그 슬롯에 들어갈 얼굴이 필요하다 — `GrokImageClient` 가 같은 이유로 `GeminiImageClient` 를 상속한 것과 같은 자리다. ★사다리의 `_cross_client()` 는 「primary 가 Grok 이 아니면 Grok」이라, 이 클라이언트를 primary 로 두면 **교차가 grok** 이고 그다음이 seedream 이다 — 지시한 순서가 그대로 나온다. ★단계는 **여섯**이지 셋이 아니다 (Codex 정정): GPT → GPT 같은 모델 재시도 → Grok → Seedream → GPT 연화 → Grok 연화. 그리고 이 사다리 자체가 `still_safety_fallback_enabled=True` 일 때만 쓰인다. 상속 재사용: `set_context`/`_ctx`/`_trace_step`/`_log_ctx`/`_opik_meta`. 오버라이드: 운반층(`generate_image`)뿐이다. ★기록은 **`call_gpt_image_bytes` 가 한다**(`record_provider_call`). 여기서 `image_tracer` 로 또 적지 않는다 — 같은 호출을 두 번 세게 된다. ★예산 문은 여기서 지난다(`reserve_current_call`) — 다른 gpt-image 자리와 같은 관례다. ) annotationsN)Path)AnyDictListOptionalTuple)reserve_current_call)GeminiImageClient1536x864864x1536 1024x1024)z16:9z9:16z1:1zDict[str, str]SIZE_BY_ASPECTc|stStjt|j }|r|St j d|ttS)u!비율 문자열 → 크기. 모르는 값은 **기본(16:9)** 으로 두고 경고한다. ★크게 실패시키지 않는 이유: 이 경로는 16:9 만 받는다. 뜻밖의 값이 오면 그림을 잃는 것보다 **16:9 로 그리고 로그에 남기는** 쪽이 낫다. uAgpt_image_client: 모르는 비율 %r — 기본 %s 로 그린다) DEFAULT_SIZErgetstrstriploggerwarning) aspect_ratiohits V/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/llm/gpt_image_client.py resolve_sizer;sO    S.446 7C   NNKl$ c`eZdZdZ d dfd ZddZ d d dZxZS) GptImageClientuJgpt-image-2.5 — `generate_image(prompt, labeled_references=...)` 계약.cnddlm}t| ||xs t |dd||_d|_y)Nr)settingsopenai_image_modelzgpt-image-2.5-sunburst)api_keymodel)app.core.configrsuper__init__getattr_quality_openai_client)selfr!r"quality_s __class__s rr%zGptImageClient.__init__OsH 3 D7(*BD    #'rcV|jddlm}||_|jS)Nr)_resolve_openai_client)r($app.core.steps.shot_conti_light_stepr.)r)r.s r_clientzGptImageClient._client\s,    & #9":D """rcJddlm}t|xsg}|s|r|Dcgc]}d|f}}tj}t j d5} g} t|D]\} \} } | td| dt| ttfrGt| | d d z }|jt| | jt|wtt| }|j!std| d || jt|t#d ||j%| rdnd|| xsd|j&t)||j*ddt|j,j/dxsd|j,j1Dcic] \}}|dvr||c}}}ddds t3d|t5tj|z dzfScc}wcc}}w#1swYFxYw)u(PNG bytes, ms) 반환. 참조가 있으면 `edit`, 없으면 `generate`. ★**라벨은 그림에 안 실린다.** gpt-image 의 `images.edit` 은 파일을 **순서대로** 받을 뿐 라벨 칸이 없다 — 무엇이 무엇인지는 **문안이** 말한다. 그래서 여기서 라벨을 버리되 **순서는 지킨다**. 수동 수리 8장이 같은 방식으로 나갔고 다 맞았다. ★참조를 **조용히 빼지 않는다** — 하나가 사라지면 아예 다른 계약의 그림이 되는데 기록은 원래 계약으로 남는다(`gpt_image_gen` 주석의 2026-08-03 실측). r)call_gpt_image_bytesgptimg_)prefixNugpt_image_client: 참조 u 이 비었다02dz.pngu 파일이 없다 — zgpt_image_client.generate_image)sourceeditgenerate)r"sizer*noperation_type) project_id episode_idr=)modeprompt ref_paths call_kwargs capture_rolecapture_metadataugpt-image: 빈 응답i)#app.modules.llm.gpt_image_primitiver2listtime monotonictempfileTemporaryDirectory enumerateFileNotFoundError isinstancebytes bytearrayr write_bytesappendrexistsr r0_modelrr'_ctxritems RuntimeErrorint)r)rAreference_imagesrlabeled_referencesr2pairsbt0_tmprBilabelvalpkvpngs rgenerate_imagezGptImageClient.generate_imagefs" M'+,>,D"'E)&67&6b!W&6E7 ^^   ( ( :d#%I#,U#3B F8F80F8$ F8 < F8  F8rr)rrhrir)rn __future__rloggingrJrHpathlibrtypingrrrrr app.core.image_call_budgetr #app.modules.llm.gemini_image_clientr getLoggerrkrr__annotations__rrrrrrysm8# 33;A   8 $   "  "`8&`8r