Create Viral Ad Clone Project

curl --request POST \
  --url https://api.loova.ai/api/v1/video/viral-ads-clone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reference_video_url": "https://example.com/reference.mp4",
  "product_image_urls": [
    "https://example.com/product-front.jpg",
    "https://example.com/product-side.jpg"
  ],
  "avatar_image_url": "https://example.com/avatar.jpg",
  "prompt": "Create a UGC-style skincare ad, keep the tone natural.",
  "aspect_ratio": "9:16",
  "speech_language_option": "",
  "duration": 15,
  "resolution": 720,
  "out_number": 1,
  "mode": "auto"
}
'

import requests

url = "https://api.loova.ai/api/v1/video/viral-ads-clone"

payload = {
    "reference_video_url": "https://example.com/reference.mp4",
    "product_image_urls": ["https://example.com/product-front.jpg", "https://example.com/product-side.jpg"],
    "avatar_image_url": "https://example.com/avatar.jpg",
    "prompt": "Create a UGC-style skincare ad, keep the tone natural.",
    "aspect_ratio": "9:16",
    "speech_language_option": "",
    "duration": 15,
    "resolution": 720,
    "out_number": 1,
    "mode": "auto"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    reference_video_url: 'https://example.com/reference.mp4',
    product_image_urls: [
      'https://example.com/product-front.jpg',
      'https://example.com/product-side.jpg'
    ],
    avatar_image_url: 'https://example.com/avatar.jpg',
    prompt: 'Create a UGC-style skincare ad, keep the tone natural.',
    aspect_ratio: '9:16',
    speech_language_option: '',
    duration: 15,
    resolution: 720,
    out_number: 1,
    mode: 'auto'
  })
};

fetch('https://api.loova.ai/api/v1/video/viral-ads-clone', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.loova.ai/api/v1/video/viral-ads-clone",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'reference_video_url' => 'https://example.com/reference.mp4',
    'product_image_urls' => [
        'https://example.com/product-front.jpg',
        'https://example.com/product-side.jpg'
    ],
    'avatar_image_url' => 'https://example.com/avatar.jpg',
    'prompt' => 'Create a UGC-style skincare ad, keep the tone natural.',
    'aspect_ratio' => '9:16',
    'speech_language_option' => '',
    'duration' => 15,
    'resolution' => 720,
    'out_number' => 1,
    'mode' => 'auto'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.loova.ai/api/v1/video/viral-ads-clone"

	payload := strings.NewReader("{\n  \"reference_video_url\": \"https://example.com/reference.mp4\",\n  \"product_image_urls\": [\n    \"https://example.com/product-front.jpg\",\n    \"https://example.com/product-side.jpg\"\n  ],\n  \"avatar_image_url\": \"https://example.com/avatar.jpg\",\n  \"prompt\": \"Create a UGC-style skincare ad, keep the tone natural.\",\n  \"aspect_ratio\": \"9:16\",\n  \"speech_language_option\": \"\",\n  \"duration\": 15,\n  \"resolution\": 720,\n  \"out_number\": 1,\n  \"mode\": \"auto\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.loova.ai/api/v1/video/viral-ads-clone")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"reference_video_url\": \"https://example.com/reference.mp4\",\n  \"product_image_urls\": [\n    \"https://example.com/product-front.jpg\",\n    \"https://example.com/product-side.jpg\"\n  ],\n  \"avatar_image_url\": \"https://example.com/avatar.jpg\",\n  \"prompt\": \"Create a UGC-style skincare ad, keep the tone natural.\",\n  \"aspect_ratio\": \"9:16\",\n  \"speech_language_option\": \"\",\n  \"duration\": 15,\n  \"resolution\": 720,\n  \"out_number\": 1,\n  \"mode\": \"auto\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.loova.ai/api/v1/video/viral-ads-clone")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"reference_video_url\": \"https://example.com/reference.mp4\",\n  \"product_image_urls\": [\n    \"https://example.com/product-front.jpg\",\n    \"https://example.com/product-side.jpg\"\n  ],\n  \"avatar_image_url\": \"https://example.com/avatar.jpg\",\n  \"prompt\": \"Create a UGC-style skincare ad, keep the tone natural.\",\n  \"aspect_ratio\": \"9:16\",\n  \"speech_language_option\": \"\",\n  \"duration\": 15,\n  \"resolution\": 720,\n  \"out_number\": 1,\n  \"mode\": \"auto\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "trace_id": "45c30d76f06549b199a3775544515689",
  "message": null,
  "data": {
    "project_id": "683f1a2b3c4d5e6f7890abcd",
    "status": "draft",
    "current_step": "preparing_media",
    "mode": "auto",
    "credits_cost": 10,
    "created_at": "2026-06-15T08:00:00Z"
  }
}

POST

video

viral-ads-clone

Create Viral Ad Clone Project

curl --request POST \
  --url https://api.loova.ai/api/v1/video/viral-ads-clone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reference_video_url": "https://example.com/reference.mp4",
  "product_image_urls": [
    "https://example.com/product-front.jpg",
    "https://example.com/product-side.jpg"
  ],
  "avatar_image_url": "https://example.com/avatar.jpg",
  "prompt": "Create a UGC-style skincare ad, keep the tone natural.",
  "aspect_ratio": "9:16",
  "speech_language_option": "",
  "duration": 15,
  "resolution": 720,
  "out_number": 1,
  "mode": "auto"
}
'

import requests

url = "https://api.loova.ai/api/v1/video/viral-ads-clone"

payload = {
    "reference_video_url": "https://example.com/reference.mp4",
    "product_image_urls": ["https://example.com/product-front.jpg", "https://example.com/product-side.jpg"],
    "avatar_image_url": "https://example.com/avatar.jpg",
    "prompt": "Create a UGC-style skincare ad, keep the tone natural.",
    "aspect_ratio": "9:16",
    "speech_language_option": "",
    "duration": 15,
    "resolution": 720,
    "out_number": 1,
    "mode": "auto"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    reference_video_url: 'https://example.com/reference.mp4',
    product_image_urls: [
      'https://example.com/product-front.jpg',
      'https://example.com/product-side.jpg'
    ],
    avatar_image_url: 'https://example.com/avatar.jpg',
    prompt: 'Create a UGC-style skincare ad, keep the tone natural.',
    aspect_ratio: '9:16',
    speech_language_option: '',
    duration: 15,
    resolution: 720,
    out_number: 1,
    mode: 'auto'
  })
};

fetch('https://api.loova.ai/api/v1/video/viral-ads-clone', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.loova.ai/api/v1/video/viral-ads-clone",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'reference_video_url' => 'https://example.com/reference.mp4',
    'product_image_urls' => [
        'https://example.com/product-front.jpg',
        'https://example.com/product-side.jpg'
    ],
    'avatar_image_url' => 'https://example.com/avatar.jpg',
    'prompt' => 'Create a UGC-style skincare ad, keep the tone natural.',
    'aspect_ratio' => '9:16',
    'speech_language_option' => '',
    'duration' => 15,
    'resolution' => 720,
    'out_number' => 1,
    'mode' => 'auto'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.loova.ai/api/v1/video/viral-ads-clone"

	payload := strings.NewReader("{\n  \"reference_video_url\": \"https://example.com/reference.mp4\",\n  \"product_image_urls\": [\n    \"https://example.com/product-front.jpg\",\n    \"https://example.com/product-side.jpg\"\n  ],\n  \"avatar_image_url\": \"https://example.com/avatar.jpg\",\n  \"prompt\": \"Create a UGC-style skincare ad, keep the tone natural.\",\n  \"aspect_ratio\": \"9:16\",\n  \"speech_language_option\": \"\",\n  \"duration\": 15,\n  \"resolution\": 720,\n  \"out_number\": 1,\n  \"mode\": \"auto\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.loova.ai/api/v1/video/viral-ads-clone")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"reference_video_url\": \"https://example.com/reference.mp4\",\n  \"product_image_urls\": [\n    \"https://example.com/product-front.jpg\",\n    \"https://example.com/product-side.jpg\"\n  ],\n  \"avatar_image_url\": \"https://example.com/avatar.jpg\",\n  \"prompt\": \"Create a UGC-style skincare ad, keep the tone natural.\",\n  \"aspect_ratio\": \"9:16\",\n  \"speech_language_option\": \"\",\n  \"duration\": 15,\n  \"resolution\": 720,\n  \"out_number\": 1,\n  \"mode\": \"auto\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.loova.ai/api/v1/video/viral-ads-clone")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"reference_video_url\": \"https://example.com/reference.mp4\",\n  \"product_image_urls\": [\n    \"https://example.com/product-front.jpg\",\n    \"https://example.com/product-side.jpg\"\n  ],\n  \"avatar_image_url\": \"https://example.com/avatar.jpg\",\n  \"prompt\": \"Create a UGC-style skincare ad, keep the tone natural.\",\n  \"aspect_ratio\": \"9:16\",\n  \"speech_language_option\": \"\",\n  \"duration\": 15,\n  \"resolution\": 720,\n  \"out_number\": 1,\n  \"mode\": \"auto\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "trace_id": "45c30d76f06549b199a3775544515689",
  "message": null,
  "data": {
    "project_id": "683f1a2b3c4d5e6f7890abcd",
    "status": "draft",
    "current_step": "preparing_media",
    "mode": "auto",
    "credits_cost": 10,
    "created_at": "2026-06-15T08:00:00Z"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Validation rules:

reference_video_url is required and must be an HTTP or HTTPS URL
product_image_urls is required and must contain at least one HTTP or HTTPS URL
avatar_image_url, if provided, must be an HTTP or HTTPS URL
speech_language_option, if provided, controls only generated spoken_audio language
out_number must be between 1 and 4
mode must be auto or manual

reference_video_url

string<uri>

required

Public HTTP or HTTPS URL of the reference ad video. The server stores this media internally before creating the project.

product_image_urls

string<uri>[]

required

Public HTTP or HTTPS URLs of product reference images. These images are stored internally and used for product analysis and video generation.

Minimum array length: 1

avatar_image_url

string<uri> | null

Optional public HTTP or HTTPS URL of a person, avatar, model, or spokesperson reference image.

prompt

string | null

Optional user instruction, such as selling points, style, restrictions, or language preference.

aspect_ratio

enum<string>

default:9:16

Target video aspect ratio.

Available options:

9:16,

1:1,

16:9

speech_language_option

enum<string> | null

default:""

Optional spoken language preference for generated spoken_audio, including voiceover, narration, dialogue, speaker turns, and short verbal expressions. Use an empty string to follow the reference video's spoken language. If a target language value is provided, it takes priority over language instructions in prompt. This field does not change visual structure, background music, lyrics, sound effects, pacing, camera behavior, or audio sync.

Available options:

english,

spanish,

portuguese,

french,

german,

arabic,

chinese,

japanese,

korean,

vietnamese,

thai,

indonesian,

malay,

filipino,

hindi

duration

integer

default:15

Target video duration in seconds.

resolution

default:720

Target video resolution. Common values include 720 and 1080.

out_number

integer

default:1

Number of videos to create automatically in auto mode, or the default batch size used by the videos endpoint when not provided.

Required range: 1 <= x <= 4

mode

enum<string>

default:auto

auto creates the first video batch automatically after the script is ready. manual only generates the script and waits for the videos endpoint.

Available options:

auto,

manual

Response

Successful response

code

integer

trace_id

string

message

string | null

data

object

Show child attributes

Check API Credits Get Viral Ad Clone Project

Getting Started

Guides

API Reference

Create Viral Ad Clone Project

Authorizations

Body

Response