Interface: VideoGenerateRequest
Defined in: packages/agentos/src/io/media/video/types.ts:127
Request payload for text-to-video generation.
Passed to IVideoGenerator.generateVideo by the high-level orchestration layer after normalising user input.
Properties
aspectRatio?
optionalaspectRatio:VideoAspectRatio
Defined in: packages/agentos/src/io/media/video/types.ts:137
Desired aspect ratio (e.g. '16:9').
durationSec?
optionaldurationSec:number
Defined in: packages/agentos/src/io/media/video/types.ts:135
Desired output duration in seconds.
fps?
optionalfps:number
Defined in: packages/agentos/src/io/media/video/types.ts:152
Frames per second for the output video.
modelId?
optionalmodelId:string
Defined in: packages/agentos/src/io/media/video/types.ts:129
Model identifier to use for generation (e.g. 'gen-3-alpha').
n?
optionaln:number
Defined in: packages/agentos/src/io/media/video/types.ts:156
Number of videos to generate. Defaults to 1.
negativePrompt?
optionalnegativePrompt:string
Defined in: packages/agentos/src/io/media/video/types.ts:133
Negative prompt describing content to avoid.
outputFormat?
optionaloutputFormat:VideoOutputFormat
Defined in: packages/agentos/src/io/media/video/types.ts:150
Output container format. Defaults to 'mp4'.
prompt
prompt:
string
Defined in: packages/agentos/src/io/media/video/types.ts:131
Text prompt describing the desired video content.
providerOptions?
optionalproviderOptions:Record<string,unknown> |VideoProviderOptionBag
Defined in: packages/agentos/src/io/media/video/types.ts:163
Provider-specific model inputs: a VideoProviderOptionBag keyed by provider id, or a flat object that fal, Replicate and Gemini receive whole.
referenceImages?
optionalreferenceImages:VideoImageInput[]
Defined in: packages/agentos/src/io/media/video/types.ts:148
Images of subjects or assets the video must keep consistent
(reference-to-video). Sent as fal's reference_image_urls, Replicate's
reference_images, or Gemini image parts.
resolution?
optionalresolution:string
Defined in: packages/agentos/src/io/media/video/types.ts:142
Desired output resolution, in the model's own vocabulary (for example
'720p', '1080p', or fal's '768P' for MiniMax). Sent as given.
seed?
optionalseed:number
Defined in: packages/agentos/src/io/media/video/types.ts:154
Seed for reproducible output.
userId?
optionaluserId:string
Defined in: packages/agentos/src/io/media/video/types.ts:158
Identifier of the requesting user (for billing / rate limiting).