---
title: "Remake a reference video with your product"
method: POST
path: "/clips/remake"
---

# Remake a reference video with your product

`POST /clips/remake`

## Request

- Base URL: `https://app.cartviral.com/api/v1`
- URL: `https://app.cartviral.com/api/v1/clips/remake`
- 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`)

Turn a proven video into a new clip starring one of your catalog products: CartViral's engine watches the reference end to end (its hook, beats and pacing), then writes and shoots a new script around your product, never the reference's people or brand. The reference must be a direct https link to a video file, or a link already uploaded through the CartViral Studio's Customize panel (a /u/... link); TikTok, Instagram, YouTube and other social post pages cannot be read yet, so a plain post link is refused before anything is charged. Same price and refund-on-failure as an ai_story clip (see generate_clips). AI clips take 10-15 minutes. Poll list_clips for download links.

## Request body

- object
  - `product_id` string, required: Product id from list_products
  - `reference_url` string, required: A direct https link to the reference video file, or a CartViral-uploaded /u/... link. Social post pages (TikTok, Instagram, YouTube Shorts, etc.) are not readable yet and are refused with a clear message.
  - `note` string: Optional: what to change or emphasize, e.g. 'keep the hook but open on the product being unboxed'

## Response `200`

Success

- object

## Other responses

- `400`: Invalid input or the action could not be done; body has an error message
- `401`: Missing or invalid credentials
- `429`: Rate limit: 120 calls per minute per key

---

[API](https://skmtc.dev/cartviral/apis/cartviral-api.md) · [All operations](https://skmtc.dev/cartviral/apis/cartviral-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cartviral/apis/cartviral-api/revisions/3dc286be9e24?raw)