Queue clips of a product

Queue vertical 9:16 clips (TikTok, Reels, Shorts) of one catalog product. Types and credit cost: montage (1, fast photo montage, ready in a few minutes), ai_story (6, an AI story written and shot by CartViral's AI engine), avatar (12, a creator on camera talks about the product), ad (6, kept for older integrations: the same AI clip as ai_story, the engine makes native clips without price tags). AI clips take 10-15 minutes. Optional format: an exact engine format id instead of letting the brain pick one (e.g. ugc_dupe for a dupe-style creator clip); its family must match clip_type, ai_story and ad need a story format, avatar needs a creator/UGC format, montage has no formats. Credits are charged from the account; a failed render refunds automatically. Poll list_clips for download links.

post/clips

Request

  • Base URL: https://app.cartviral.com/api/v1
  • URL: https://app.cartviral.com/api/v1/clips
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.cartviral.com/oauth/authorize, token URL https://app.cartviral.com/oauth/token, scopes: mcp)

Request body

product_idstring required

Product id from list_products

clip_type'montage' | 'ai_story' | 'ad' | 'avatar' required
format'demo_loop' | 'ugc_discovery' | 'try_on' | 'double_take' | 'problem_hack' | 'before_after' | 'uses_list' | 'dont_show' | 'pov_moment' | 'test_challenge' | 'grwm' | 'fit_check_honest' | 'texture_macro' | 'first_reaction' | 'lights_on_reveal' | 'maker_process' | 'makes_sense' | 'build_a_stack' | 'ugc_review' | 'ugc_unboxing' | 'ugc_first_reaction' | 'grwm_talk' | 'ugc_storytime' | 'ugc_top3' | 'ugc_before_you_buy' | 'ugc_dupe' | 'ugc_regret' | 'ugc_dilo' | 'progress_diary' | 'pov_asmr_hands' | 'product_asmr'

Optional exact format id; must fit clip_type's family (story for ai_story/ad, ugc for avatar). Leave out to let the engine pick.

countinteger

Response

Success

object required

Changes

No recorded changes to this operation across all 1 revision of this API.