Film Actor

film_actor

Film Actor digital human video generation model. Supports generating digital human videos from reference videos and images.

Authentication

authorization `string` required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key

Usage:

Add to request header:

Authorization: Bearer YOUR_API_KEY

Parameters

model `string` required

Model ID to use for the request.

Value: film_actor

video_url `string` required

Reference video URL.

image_url `string` required

Image URL.

seed `integer`

Random seed, must be -1 or positive integer.

video_quality `string`

Video quality.

Options: normal (normal), high (high quality)

return_url `boolean`

Whether to return URL.

Error Codes

Code	Description
401	API key is missing or invalid
403	Insufficient balance or permission denied
429	Rate limit exceeded
500	Internal server error

Code Examples

curl --location 'https://cloud.vtrix.ai/model/v1/generation' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
  "model": "film_actor",
  "input": [
    {
      "params": {
        "video_url": "https://example.com/video.mp4",
        "image_url": "https://example.com/image.jpg",
        "seed": -1,
        "video_quality": "normal"
      }
    }
  ]
}'

Response Format

{
  "type": "video",
  "url": "Generated content URL",
  "jobId": "Job identifier"
}

Authentication

authorization string required

Parameters

model string required

video_url string required

image_url string required

seed integer

video_quality string

return_url boolean