> ## Documentation Index
> Fetch the complete documentation index at: https://docs.copyfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# copy_video_ad

> Remake a winning video ad for your product with Copyfy's Video Creator.

Remakes up to 15 seconds of a video ad with Copyfy's Video Creator, like **Copy video ad** on the dashboard's Ads page. Copyfy analyses the original clip (structure, pacing, hook, message) and generates a new 15-second video that follows it, showing your product when you pass one. The video is saved to your Copyfy library.

It works on ads whose `video_url` is set in [`search_ads`](https://docs.copyfy.io/tools/search-ads): Copyfy needs a copy of the video it stored itself, since links from Meta expire.

Copyfy tells your assistant to state the cost and wait for your go-ahead before calling it, and marks it as a tool that spends credits, so your client can ask you first.

**Cost:** 1 MCP credit, given back if the remake fails, plus AI credits: 30 with `bytedance/seedance-2.5` (default, as in the dashboard), 10 with `bytedance/seedance-2.0-fast`. Videos spend AI credits only, not legacy image credits. If no video comes out, the AI credits are refunded.

## Arguments

| Argument | Type | Allowed values |
| - | - | - |
| `ad_id` | integer or numeric string | Id of a video ad from [`search_ads`](https://docs.copyfy.io/tools/search-ads). |
| `ad_archive_id` | integer or numeric string | The ad's Meta Ad Library id, instead of `ad_id`. |
| `product_id` | integer or numeric string | Copyfy product id: the remake shows this product, with its image as the product reference. |
| `start_seconds` | number | Start of the part to remake. Default 0. |
| `end_seconds` | number | End of that part, at most 15 seconds after `start_seconds`. Default: `start_seconds` + 15, cut at the end of the video. |
| `prompt` | string | Up to 2,000 characters. What to change, such as the hook, the setting, or the language of the text. |
| `model` | string | `bytedance/seedance-2.5` (default, 30 AI credits, as in the dashboard) or `bytedance/seedance-2.0-fast` (10 AI credits, for drafts or a tighter budget). |
| `aspect_ratio` | string | `9:16` (default), `1:1`, `4:3`, `3:4`, `16:9`, `21:9`. |
| `language` | string | `auto` (default, follows the original ad), `english`, `french`, `spanish`. |
| `max_ai_credits` | number | The most AI credits you accept to spend. A call that would cost more is refused and nothing is charged. |

## Example

```json Tool call theme={null}
{
  "name": "copy_video_ad",
  "arguments": { "ad_id": 88120034, "product_id": 4419021, "max_ai_credits": 30 }
}
```

```json Result theme={null}
{
  "job": { "id": "vid_mcp-0b7d4c3a8e5f1b2c3d4e5f606f1c2a9e", "kind": "video_ad", "status": "running", "poll_after_seconds": 30, "expected_seconds": 300 },
  "ai_credits": { "charged": 30, "remaining": null },
  "mcp_credits_charged": 1,
  "model": "bytedance/seedance-2.5",
  "source_ad": { "id": 88120034, "ad_archive_id": "1203948576612345", "window_seconds": [0, 15] },
  "product": { "id": 4419021, "title": "Self-Cleaning Pet Brush" },
  "dashboard_url": "https://app.copyfy.io/dashboard/creatives-ai",
  "library_url": "https://app.copyfy.io/library",
  "message": "Copyfy is remaking the video; it usually takes 4 to 7 minutes. Call get_job_status with job.id about every poll_after_seconds; the video is also saved to the user's Copyfy library."
}
```

Rendering takes 4 to 7 minutes. Follow the job with [`get_job_status`](https://docs.copyfy.io/tools/get-job-status): when it succeeds, `videos` lists the `video_url`.

## Errors

| Code | When |
| - | - |
| [`insufficient_credits`](https://docs.copyfy.io/errors#insufficient_credits) | Not enough AI credits. Nothing is charged. The error includes `required_credits`, `remaining_credits`, and `buy_credits_url`. |
| [`cost_limit_exceeded`](https://docs.copyfy.io/errors#cost_limit_exceeded) | The remake costs more than `max_ai_credits`. Nothing is charged. |
| [`paid_plan_required`](https://docs.copyfy.io/errors#paid_plan_required) | The account is in a trial. |
| [`invalid_arguments`](https://docs.copyfy.io/errors#invalid_arguments) | Both or neither of `ad_id` and `ad_archive_id`, or a window longer than 15 seconds. |
| [`not_found`](https://docs.copyfy.io/errors#not_found) | No Copyfy ad or product has this id. |
| [`media_unavailable`](https://docs.copyfy.io/errors#media_unavailable) | Copyfy has no stored video for this ad, or could not download the product image. |
| [`rate_limited`](https://docs.copyfy.io/errors#rate_limited) | Too many video generations were started recently. |
| [`service_unavailable`](https://docs.copyfy.io/errors#service_unavailable) | The remake could not start. When the error includes `job_id`, Copyfy could not confirm whether it started, and the MCP credit stays set aside until the job settles it: check that job with [`get_job_status`](https://docs.copyfy.io/tools/get-job-status) before trying again. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.