본문으로 건너뛰기

인터페이스: MediaInputMetadata

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

미디어 생성에 사용하는 이미지 / 동영상 / 오디오 입력의 메타데이터 규약입니다. generateImage() 또는 generateVideo()의 조건 입력으로 사용할 때 ImagePart.metadata / VideoPart.metadata / AudioPart.metadata에 포함됩니다.

속성​

role?​

optional role?: MediaInputRole;

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

어댑터가 파트의 의도를 구분할 수 있도록 제공하는 선택적 역할 힌트입니다.

tag?​

optional tag?: string;

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

이 입력에 대한 선택적 사용자 정의 레이블입니다(예: 'woman-in-red-dress'). 정보 제공만을 위한 값이며, 어댑터는 이를 읽지 않고 SDK도 이를 기반으로 프롬프트 텍스트를 다시 작성하지 않습니다. 파트를 프롬프트에서 공급자의 고유 구문으로 작성한 참조(fal의 @Image1, OpenAI의 "image 1" 등)와 연결하거나 자체 기록/로깅에 사용합니다.