product_promo_video

Generate a promotional short video from structured product information, features, call to action and optional website.

When to use

Use when an agent needs a publish-ready product or service promotion from structured marketing input.

Selection guidance

Role: specialized. Use when an agent needs a publish-ready product or service promotion from structured marketing input.

Use cases

• product promo video
• marketing video
• product advertisement
• service promotion

Access

• REST: POST https://api.rafidsystem.com/api/v1/video/product-promo
• x402: POST https://api.rafidsystem.com/api/v1/x402/video/product-promo
• MCP tool: product_promo_video
• Free preview: POST https://api.rafidsystem.com/api/v1/preview/product_promo_video

Price: $2.00 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.

Related tools

• news_video_generate

Example input

{
  "productName": "Rafid Property System",
  "description": "Facility and property management platform",
  "features": [
    "Maintenance management",
    "Property management",
    "Finance",
    "Contracts"
  ],
  "callToAction": "Book a demo",
  "website": "https://rafidsystem.com",
  "language": "en",
  "durationSeconds": 30,
  "aspectRatio": "9:16",
  "voice": "auto",
  "subtitles": true,
  "backgroundMusic": true
}

Example output

{
  "success": true,
  "capability": "product_promo_video",
  "task": {
    "id": "mpt-task-id",
    "status": "completed"
  },
  "video": {
    "url": "https://video.example/mpt-task-id.mp4",
    "durationSeconds": null,
    "aspectRatio": "9:16",
    "resolution": "1080x1920"
  },
  "content": {
    "script": null,
    "language": "en"
  },
  "assets": {
    "audioUrl": null,
    "subtitleUrl": null,
    "materialUrls": []
  },
  "engine": {
    "provider": "MoneyPrinterTurbo",
    "upstreamTaskId": "mpt-task-id"
  },
  "billing": {
    "priceUsd": 2
  },
  "generatedAt": "2026-01-01T00:00:00.000Z"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "productName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "description": {
      "type": "string",
      "minLength": 1,
      "maxLength": 3000
    },
    "features": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500
      }
    },
    "callToAction": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "website": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri"
    },
    "language": {
      "default": "en",
      "type": "string",
      "minLength": 2,
      "maxLength": 32
    },
    "durationSeconds": {
      "default": 30,
      "type": "integer",
      "minimum": 5,
      "maximum": 120
    },
    "aspectRatio": {
      "default": "9:16",
      "type": "string",
      "enum": [
        "9:16",
        "16:9",
        "1:1"
      ]
    },
    "voice": {
      "default": "auto",
      "type": "string",
      "maxLength": 128
    },
    "subtitles": {
      "default": true,
      "type": "boolean"
    },
    "backgroundMusic": {
      "default": true,
      "type": "boolean"
    }
  },
  "required": [
    "productName",
    "description",
    "features",
    "callToAction",
    "language",
    "durationSeconds",
    "aspectRatio",
    "voice",
    "subtitles",
    "backgroundMusic"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "const": true
    },
    "capability": {
      "type": "string"
    },
    "task": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "processing",
            "completed"
          ]
        }
      },
      "required": [
        "id",
        "status"
      ],
      "additionalProperties": false
    },
    "video": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string",
          "format": "uri"
        },
        "durationSeconds": {
          "anyOf": [
            {
              "type": "number",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ]
        },
        "aspectRatio": {
          "type": "string",
          "enum": [
            "9:16",
            "16:9",
            "1:1"
          ]
        },
        "resolution": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "url",
        "durationSeconds",
        "aspectRatio",
        "resolution"
      ],
      "additionalProperties": false
    },
    "content": {
      "type": "object",
      "properties": {
        "script": {
          "type": [
            "string",
            "null"
          ]
        },
        "language": {
          "type": "string"
        }
      },
      "required": [
        "script",
        "language"
      ],
      "additionalProperties": false
    },
    "assets": {
      "type": "object",
      "properties": {
        "audioUrl": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "subtitleUrl": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "materialUrls": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "required": [
        "audioUrl",
        "subtitleUrl",
        "materialUrls"
      ],
      "additionalProperties": false
    },
    "metadata": {
      "type": "object",
      "properties": {
        "sourceUrls": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "required": [
        "sourceUrls"
      ],
      "additionalProperties": false
    },
    "engine": {
      "type": "object",
      "properties": {
        "provider": {
          "type": "string",
          "const": "MoneyPrinterTurbo"
        },
        "upstreamTaskId": {
          "type": "string"
        }
      },
      "required": [
        "provider",
        "upstreamTaskId"
      ],
      "additionalProperties": false
    },
    "billing": {
      "type": "object",
      "properties": {
        "priceUsd": {
          "type": "number",
          "exclusiveMinimum": 0
        }
      },
      "required": [
        "priceUsd"
      ],
      "additionalProperties": false
    },
    "generatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "success",
    "capability",
    "task",
    "video",
    "content",
    "assets",
    "engine",
    "billing",
    "generatedAt"
  ],
  "additionalProperties": false
}

Category: Video Generation · hierarchy: specialized · idempotent: yes · side effects: yes