v1

latestOpenAPI 3.0.1MIT2026-07-2638658.5 KB

Video

Submit Preview List

Submit multiple visual styles for preview generation from a product. This allows you to generate multiple preview videos with different styles simultaneously.

post/v2/create_video_from_product/preview_list

Request body

product_idstring required

Product ID

visual_stylesstring[] required

List of visual style names to generate previews

languagestring

Script generation language

override_scriptstring

Override the auto-generated script

webhook_urlstring uri

Webhook URL for status notifications

Example request

{
  "product_id": "NTIzMzc0NjI5",
  "visual_styles": [
    "Simple Product Switch",
    "Dynamic Showcase"
  ],
  "video_spec": {
    "aspect_ratio": "landscape",
    "length": "30",
    "caption": true,
    "name": "My Product Video"
  },
  "avatar": {
    "id": 1
  },
  "voice": {
    "id": "en-US-ChristopherNeural"
  },
  "audio": {
    "music_id": 13
  },
  "script": {
    "style": "Storytime"
  },
  "language": "english",
  "webhook_url": "https://example.com/webhook"
}

Response

Success

codeinteger required

Business status code:

0 - Success
10104 - Record not found
10105 - Invalid API key
18020 - Insufficient credit
18025 - No permission to call APIs
40000 - Parameter error
50000 - System error

msgstring required

Response message

Example response

{
  "msg": "Success",
  "data": {
    "previews": [
      {
        "visual_style": "Simple Product Switch",
        "preview_id": "preview_456",
        "err_msg": "Generation failed due to invalid parameters"
      }
    ]
  }
}