VEED Fabric 1.0

This entry is Runware's hosted deployment of VEED Fabric 1.0. It generates short speaking videos by animating a static image with synchronized speech and expressive motion, aligning lip movements, facial expressions, head gestures, and body motion to an audio input while preserving the appearance of the source image. It exists separately from the TPI-hosted VEED Fabric 1.0 model because the hosted deployment has a different API surface.

Complete technical specification for integration
API Options
Platform-level options for task execution and delivery.
taskType
stringrequiredvalue: videoInferenceIdentifier for the type of task being performed
taskUUID
stringrequiredUUID v4UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.
outputType
stringdefault: URLVideo output type.
Allowed values1 value
outputFormat
stringdefault: MP4Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.
- `MP4`: Widely supported video container (H.264), recommended for general use.
- `WEBM`: Optimized for web delivery.
- `MOV`: QuickTime format, common in professional workflows (Apple ecosystem).
Allowed values3 values
outputQuality
integermin: 20max: 99default: 95Compression quality of the output. Higher values preserve quality but increase file size.
webhookURL
stringURISpecifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.
Learn more1 resource
- WebhooksPLATFORM
- Webhooks
deliveryMethod
stringdefault: asyncDetermines how the API delivers task results.
Allowed values1 value
- Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse. Required for long-running tasks like video generation.
Learn more1 resource
- Task PollingPLATFORM
uploadEndpoint
stringURISpecifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.
Common use cases:
- Cloud storage: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- CDN integration: Upload to content delivery networks for immediate distribution.
// S3 presigned URL for secure upload https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600 // Google Cloud Storage presigned URL https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789 // Custom storage endpoint https://storage.example.com/uploads/generated-image.jpgThe content data will be sent as the request body to the specified URL when generation is complete.
safety
objectContent safety checking configuration for video generation.
Properties2 properties
safety»checkContentcheckContent
booleanEnable or disable content safety checking.
safety»modemode
stringdefault: noneSafety checking mode for video generation.
Allowed values3 values
- Disables checking.
- Checks key frames.
- Checks all frames.
ttl
integermin: 60Time-to-live (TTL) in seconds for generated content. Only applies when
outputTypeisURL.
includeCost
booleanInclude task cost in the response.
numberResults
integermin: 1max: 4default: 1Number of results to generate. Each result uses a different seed, producing variations of the same parameters.
acceleration
stringdefault: mediumOptimization level.
Allowed values4 values
acceleratorOptions
objectAdvanced caching mechanisms to speed up generation.
Properties7 properties
acceleratorOptions»cacheEndStepcacheEndStep
integermin: 1Absolute step number to end caching. Must be greater than
cacheStartStepand less than or equal tosteps.
acceleratorOptions»cacheEndStepPercentagecacheEndStepPercentage
integermin: 1max: 100Percentage of steps to end caching. Alternative to
cacheEndStep. Must be greater thancacheStartStepPercentage.
acceleratorOptions»cacheMaxConsecutiveStepscacheMaxConsecutiveSteps
integermin: 1max: 5default: 3Limits the maximum number of consecutive steps that can use cached computations before forcing a fresh computation.
acceleratorOptions»cacheStartStepcacheStartStep
integermin: 0Absolute step number to start caching. Must be less than
cacheEndStep.
acceleratorOptions»cacheStartStepPercentagecacheStartStepPercentage
integermin: 0max: 99Percentage of steps to start caching. Alternative to
cacheStartStep. Must be less thancacheEndStepPercentage.
acceleratorOptions»fbCachefbCache
booleanFirst Block Cache (FBCache) acceleration. Reuses feature block computations across steps.
acceleratorOptions»fbCacheThresholdfbCacheThreshold
floatmin: 0max: 1step: 0.01default: 0.25Controls the sensitivity threshold for determining when to reuse cached computations. Lower values reuse more aggressively.
Inputs
Input resources for the task (images, audio, etc). These must be nested inside the inputs object.
inputs object.Core Parameters
Primary parameters that define the task output.
model
stringrequiredvalue: veed:fabric@1.0-hostedIdentifier of the model to use for generation.
Learn more3 resources
resolution
stringdefault: 720pResolution preset for the output. When used with input media, automatically matches the aspect ratio from the input.
Allowed values2 values
Settings
Technical parameters to fine-tune the inference process. These must be nested inside the settings object.
settings object.settings»audioCFGScaleaudioCFGScale
floatmin: 0max: 20step: 0.01default: 3.05Classifier-free guidance scale for audio synchronization. Higher values produce stronger audio-video alignment.
settings»colorCorrectioncolorCorrection
booleandefault: falseApply color correction to the generated video. Helps maintain consistent colors across video segments.