타입 별칭: MediaInputRole

type MediaInputRole = 
  | "reference"
  | "mask"
  | "control"
  | "start_frame"
  | "end_frame"
  | "character";

정의 위치: packages/ai/src/types.ts:1846

미디어 입력 부분 (이미지/비디오/오디오) 에 대한 선택적 역할 힌트. 어댑터는 metadata.role 를 읽어서 해당 부분을 제공자별 요청 필드로 라우팅합니다 — 예를 들어 'mask' → OpenAI mask / fal mask_url, 'end_frame' → fal end_image_url, 'reference' → fal reference_image_urls. 생략된 경우 어댑터는 위치 기반 라우팅으로 회귀합니다.