VideoAdapter

Defined in: packages/ai/src/activities/generateVideo/adapter.ts:64

Video adapter interface with pre-resolved generics.

An adapter is created by a provider function: provider('model') → adapter All type resolution happens at the provider call site, not in this interface.

Generic parameters:

• TModel: The specific model name (e.g., 'sora-2')
• TProviderOptions: Provider-specific options (already resolved)
• TModelProviderOptionsByName: Map from model name to its specific provider options
• TModelSizeByName: Map from model name to its supported sizes
• TModelInputModalitiesByName: Map from model name to the non-text prompt modalities it accepts (constrains the prompt part types at compile time)
• TModelDurationByName: Map from model name to its supported duration union. Defaults to Record<string, number> so adapters that haven't declared a map keep today's duration?: number typing.

Type Parameters#

TModel#

TModel extends string = string

TProviderOptions#

TProviderOptions extends object = Record<string, unknown>

TModelProviderOptionsByName#

TModelProviderOptionsByName extends Record<string, any> = Record<string, any>

TModelSizeByName#

TModelSizeByName extends Record<string, string | undefined> = Record<string, string>

TModelInputModalitiesByName#

TModelInputModalitiesByName extends ModelInputModalitiesByName = ModelInputModalitiesByName

TModelDurationByName#

TModelDurationByName extends Record<string, string | number | undefined> = Record<string, number>

Properties#

~types#

~types: object;

Defined in: packages/ai/src/activities/generateVideo/adapter.ts:94

Internal

Type-only properties for inference. Not assigned at runtime.

modelDurationByName#

modelDurationByName: TModelDurationByName;

modelInputModalitiesByName#

modelInputModalitiesByName: TModelInputModalitiesByName;

modelProviderOptionsByName#

modelProviderOptionsByName: TModelProviderOptionsByName;

modelSizeByName#

modelSizeByName: TModelSizeByName;

providerOptions#

providerOptions: TProviderOptions;

availableDurations#

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

Defined in: packages/ai/src/activities/generateVideo/adapter.ts:131

Describe the durations this adapter's model accepts. Returns a tagged union so consumers can render UI / coerce input without provider-specific knowledge.

Returns#

DurationOptions<TModelDurationByName[TModel]>

createVideoJob#

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

Defined in: packages/ai/src/activities/generateVideo/adapter.ts:106

Create a new video generation job. Returns a job ID that can be used to poll for status and retrieve the video.

Parameters#

options#

VideoGenerationOptions<TProviderOptions, TModelSizeByName[TModel], TModelDurationByName[TModel]>

Returns#

Promise<VideoJobResult>

getVideo#

getVideo: (jobId) => Promise<
  | VideoUrlResult
| VideoStreamResult>;

Defined in: packages/ai/src/activities/generateVideo/adapter.ts:124

Get the finished video: a public URL when the provider has one, or the download stream for generation middleware to host. Call only after status is 'completed'.

Parameters#

jobId#

string

Returns#

Promise< | VideoUrlResult | VideoStreamResult>

getVideoStatus#

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

Defined in: packages/ai/src/activities/generateVideo/adapter.ts:117

Get the current status of a video generation job.

Parameters#

jobId#

string

Returns#

Promise<VideoStatusResult>

kind#

readonly kind: "video";

Defined in: packages/ai/src/activities/generateVideo/adapter.ts:78

Discriminator for adapter kind - used to determine API shape

model#

readonly model: TModel;

Defined in: packages/ai/src/activities/generateVideo/adapter.ts:89

The model this adapter is configured for

name#

readonly name: string;

Defined in: packages/ai/src/activities/generateVideo/adapter.ts:80

Adapter name identifier

snapDuration#

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

Defined in: packages/ai/src/activities/generateVideo/adapter.ts:140

Coerce input to the closest duration this model accepts. input may be seconds (7), a numeric string ("7"), a template ("6s"), or a keyword the model lists ("auto"). Returns undefined when the model has no duration field, or when input is a keyword that model does not list.

Parameters#

input#

string | number

Returns#

TModelDurationByName[TModel] | undefined

supportsFileSources?#

readonly optional supportsFileSources?: boolean;

Defined in: packages/ai/src/activities/generateVideo/adapter.ts:87

Declares that this adapter can consume { type: 'file' } content sources (provider Files API references). The activity dispatcher rejects file sources in preflight for adapters that don't declare this, so adapters written before the file arm existed fail closed.