Product motion video API

Start a single product-motion video job from one source image using fal's preconfigured Vidu template-to-video motions.

Price$19.98per request

MethodPOST

Route/v1/content/videos/product-motion-5s

StatusPlanned

MIME typeapplication/json

Rate limit3/minute

CacheNo cache

contentvideoimage-to-videoproducttemplatequeuefal

API URLhttps://x402.hexl.dev/v1/content/videos/product-motion-5s

Integration docs

Example request

{
  "imageUrl": "https://example.com/source-wallet.png",
  "platform": "tiktok",
  "motionStyle": "product-rise"
}

Example response

{
  "jobId": "eyJ2IjoxLCJyZXF1ZXN0SWQiOiJmYWwtcmVxdWVzdCJ9.signature",
  "status": "IN_QUEUE",
  "statusUrl": "/v1/content/jobs/eyJ2IjoxLCJyZXF1ZXN0SWQiOiJmYWwtcmVxdWVzdCJ9.signature",
  "resultUrl": "/v1/content/jobs/eyJ2IjoxLCJyZXF1ZXN0SWQiOiJmYWwtcmVxdWVzdCJ9.signature/result",
  "provider": "fal",
  "modelClass": "product-motion-video",
  "retailPrice": "$9.99/request"
}

Input schema

{
  "type": "object",
  "required": [
    "imageUrl"
  ],
  "properties": {
    "imageUrl": {
      "type": "string",
      "format": "uri"
    },
    "platform": {
      "type": "string",
      "enum": [
        "tiktok",
        "instagram",
        "youtube-shorts",
        "amazon",
        "shopify",
        "generic"
      ],
      "default": "generic"
    },
    "aspectRatio": {
      "type": "string",
      "enum": [
        "16:9",
        "9:16"
      ],
      "default": "9:16"
    },
    "motionStyle": {
      "type": "string",
      "enum": [
        "product-rise",
        "product-drop",
        "orbit",
        "fast-orbit",
        "spin",
        "zoom-in",
        "cybercity-rise",
        "bluecircuit-rise"
      ],
      "default": "product-rise"
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "jobId",
    "status",
    "statusUrl",
    "resultUrl",
    "provider",
    "modelClass",
    "retailPrice"
  ],
  "properties": {
    "jobId": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "statusUrl": {
      "type": "string"
    },
    "resultUrl": {
      "type": "string"
    },
    "provider": {
      "type": "string"
    },
    "modelClass": {
      "type": "string"
    },
    "retailPrice": {
      "type": "string"
    }
  }
}