본문으로 건너뛰기

인터페이스: ImageGenerationOptions<TProviderOptions, TSize>

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

이미지 생성 옵션입니다. 이 옵션은 모든 provider에서 공통으로 지원됩니다.

타입 매개변수​

TProviderOptions​

TProviderOptions extends object = object

TSize​

TSize extends string | undefined = string

속성​

abortSignal?​

optional abortSignal?: AbortSignal;

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

activity가 호출자의 abortSignal 및/또는 timeout으로 조합한 유효한 중단 신호입니다. 지원되는 경우 어댑터는 이를 provider SDK에 전달해야 합니다. 요청별 값이므로 전역 클라이언트 설정에 저장해서는 안 됩니다.

logger​

logger: InternalLogger;

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

generateImage() 진입점에서 전달되는 내부 로거입니다. 어댑터는 SDK 호출 전에 logger.request()를 호출하고 catch 블록에서 logger.errors()를 호출해야 합니다.

model​

model: string;

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

이미지 생성에 사용할 모델입니다.

modelOptions?​

optional modelOptions?: TProviderOptions;

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

이미지 생성을 위한 모델별 옵션입니다.

numberOfImages?​

optional numberOfImages?: number;

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

생성할 이미지 수입니다(기본값: 1).

prompt​

prompt: MediaPrompt;

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

원하는 이미지의 설명입니다. 일반 문자열이거나 이미지 조건부 생성을 위한 콘텐츠 파트의 순서가 지정된 배열일 수 있습니다. 미디어 파트에는 의도(mask, control, reference 등)를 구분하기 위한 metadata.role이 포함될 수 있습니다. 어댑터는 파트를 provider 네이티브 요청에 매핑합니다. 예를 들어 Gemini 멀티모달 contents, OpenAI images.edit(), fal image_url / mask_url로 매핑하며, 지원되지 않는 모달리티에는 명확한 런타임 오류를 발생시킵니다.

size?​

optional size?: TSize;

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

WIDTHxHEIGHT 형식의 이미지 크기입니다(예: "1024x1024").