Vtrix Motion I2V

vtrix_motion_i2v

Image-to-video generation that preserves subject identity while adding coherent and natural motion.

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: vtrix_motion_i2v

content `array` required

Content array. Supports text and image_url types.

resolution `string`

Resolution.

ratio `string`

Aspect ratio.

duration `integer`

Video duration.

Range: 3 - 12 seconds

framespersecond `integer`

Frame rate.

Options: 16, 24 fps

seed `integer`

Random seed.

Range: -1 to 2^32-1

camerafixed `boolean`

Whether to fix camera.

return_last_frame `boolean`

Whether to return last frame image.

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": "vtrix_motion_i2v",
  "input": [
    {
      "params": {
        "content": [
          {"type": "text", "text": "A dynamic scene"},
          {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
        ],
        "resolution": "720p",
        "ratio": "16:9",
        "duration": 5,
        "framespersecond": 24
      }
    }
  ]
}'

Response Format

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

Authentication

authorization string required

Parameters

model string required

content array required

resolution string

ratio string

duration integer

framespersecond integer

seed integer

camerafixed boolean

return_last_frame boolean