본문으로 건너뛰기

인터페이스: VideoAdapter<TModel, TProviderOptions, TModelProviderOptionsByName, TModelSizeByName, TModelInputModalitiesByName, TModelDurationByName>

정의 위치: packages/ai/src/activities/generateVideo/adapter.ts:60

Experimental

미리 해석된 제네릭을 사용하는 비디오 어댑터 인터페이스입니다.

어댑터는 공급자 함수로 생성됩니다: provider('model') → adapter 모든 타입 해석은 이 인터페이스가 아니라 공급자 호출 위치에서 수행됩니다.

비디오 생성은 실험적 기능이며 변경될 수 있습니다.

일반화 매개변수:

  • TModel: 특정 모델 이름 (예: 'sora-2')
  • TProviderOptions: 제공자별 옵션 (이미 해결됨)
  • TModelProviderOptionsByName: 모델 이름에서 해당 제공자 옵션으로의 맵
  • TModelSizeByName: 모델 이름에서 지원되는 크기로의 맵
  • TModelInputModalitiesByName: 모델 이름에서 비텍스트 프롬프트 모달리티로, 컴파일 시 prompt 부분 타입을 제한합니다.
  • TModelDurationByName: 모델 이름에서 지원되는 지속 시간 유니온으로, Record<string, number> 로 기본값이므로 맵을 선언하지 않은 어댑터는 duration?: number 타이핑을 유지합니다.

타입 매개변수​

TModel​

TModel extends string = string

TProviderOptions​

TProviderOptions extends object = Record&lt;string, unknown>

TModelProviderOptionsByName​

TModelProviderOptionsByName extends Record&lt;string, any> = Record&lt;string, any>

TModelSizeByName​

TModelSizeByName extends Record&lt;string, string | undefined> = Record&lt;string, string>

TModelInputModalitiesByName​

TModelInputModalitiesByName extends ModelInputModalitiesByName = ModelInputModalitiesByName

TModelDurationByName​

TModelDurationByName extends Record&lt;string, string | number | undefined> = Record&lt;string, number>

속성​

~types​

~types: object;

정의 위치: packages/ai/src/activities/generateVideo/adapter.ts:83

Internal

타입 추론 전용 속성입니다. 런타임에는 할당되지 않습니다.

modelDurationByName​

modelDurationByName: TModelDurationByName;

modelInputModalitiesByName​

modelInputModalitiesByName: TModelInputModalitiesByName;

modelProviderOptionsByName​

modelProviderOptionsByName: TModelProviderOptionsByName;

modelSizeByName​

modelSizeByName: TModelSizeByName;

providerOptions​

providerOptions: TProviderOptions;

availableDurations​

availableDurations: () => DurationOptions<TModelDurationByName[TModel]>;

정의 위치: packages/ai/src/activities/generateVideo/adapter.ts:119

Experimental

이 어댑터의 모델이 허용하는 기간을 설명합니다. 공급자별 지식 없이 소비자가 UI를 렌더링하거나 입력을 변환할 수 있도록 태그가 있는 유니온을 반환합니다.

반환값​

DurationOptions&lt;TModelDurationByName[TModel]>

createVideoJob​

createVideoJob: (options) => Promise<VideoJobResult>;

정의 위치: packages/ai/src/activities/generateVideo/adapter.ts:95

Experimental

새 비디오 생성 작업을 만듭니다. 상태를 확인하고 비디오를 가져오기 위해 사용할 수 있는 작업 ID 를 반환합니다.

매개변수​

options​

VideoGenerationOptions&lt;TProviderOptions, TModelSizeByName[TModel], TModelDurationByName[TModel]>

반환값​

Promise&lt;VideoJobResult>

getVideoStatus​

getVideoStatus: (jobId) => Promise<VideoStatusResult>;

정의 위치: packages/ai/src/activities/generateVideo/adapter.ts:106

Experimental

비디오 생성 작업의 현재 상태를 가져옵니다.

매개변수​

jobId​

string

반환값​

Promise&lt;VideoStatusResult>

getVideoUrl​

getVideoUrl: (jobId) => Promise<VideoUrlResult>;

정의 위치: packages/ai/src/activities/generateVideo/adapter.ts:112

Experimental

생성된 비디오를 다운로드/확인할 URL 을 가져옵니다. 상태가 'completed' 인 경우에만 호출해야 합니다.

매개변수​

jobId​

string

반환값​

Promise&lt;VideoUrlResult>

kind​

readonly kind: "video";

정의 위치: packages/ai/src/activities/generateVideo/adapter.ts:74

Experimental

어댑터 종류를 판별하기 위한 식별자이며 API 형태를 결정하는 데 사용됩니다.

model​

readonly model: TModel;

정의 위치: packages/ai/src/activities/generateVideo/adapter.ts:78

Experimental

이 어댑터가 구성되는 모델

name​

readonly name: string;

정의 위치: packages/ai/src/activities/generateVideo/adapter.ts:76

Experimental

어댑터 이름 식별자

snapDuration​

snapDuration: (seconds) => TModelDurationByName[TModel] | undefined;

정의 위치: packages/ai/src/activities/generateVideo/adapter.ts:125

Experimental

모델에 대한 유효한 지속 시간을 위한 원시 초 값을 강제로 변환합니다. 지속 시간 필드가 없는 모델의 경우 undefined 를 반환합니다.

매개변수​

seconds​

number

반환값​

TModelDurationByName[TModel] | undefined