Skip to main content
POST
/
api
/
ads_clone
cURL
curl --request POST \
  --url https://api.creatify.ai/api/ads_clone/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "link": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "video_url": "<string>",
  "aspect_ratio": "9x16",
  "webhook_url": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "link": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "video_url": "<string>",
  "video_output": "<string>",
  "credits_used": 123,
  "media_job": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "aspect_ratio": "9x16",
  "webhook_url": "<string>"
}

Authorizations

​
X-API-ID
string
header
required

API ID, from your settings page.

​
X-API-KEY
string
header
required

API Key, from your settings page.

Body

​
link
string<uuid>
required

UUID of a pre-created Link used for ad generation. Create the Link using the Links API and ensure it contains at least one image.

​
video_url
string<uri>
required

URL of the reference ad video

​
aspect_ratio
enum<string>
default:9x16
  • 9x16 - 9X16
  • 16x9 - 16X9
  • 1x1 - 1X1
Available options:
9x16,
16x9,
1x1
​
language

Language of the video. If null, the original language of the video is used.

  • af - Afrikaans
  • ar - Arabic
  • as - Assamese
  • az - Azerbaijani
  • be - Belarusian
  • bg - Bulgarian
  • bn - Bengali
  • bs - Bosnian
  • ca - Catalan; Valencian
  • cb - Cebuano
  • cs - Czech
  • cy - Welsh
  • da - Danish
  • de - German
  • el - Greek, Modern
  • en - English
  • es - Spanish; Castilian
  • et - Estonian
  • fa - Persian
  • fi - Finnish
  • fl - Filipino
  • fr - French
  • ga - Irish
  • gl - Galician
  • gu - Gujarati
  • ha - Hausa
  • he - Hebrew (modern)
  • hi - Hindi
  • hr - Croatian
  • hu - Hungarian
  • hy - Armenian
  • id - Indonesian
  • is - Icelandic
  • it - Italian
  • ja - Japanese
  • jv - Javanese
  • ka - Georgian
  • kk - Kazakh
  • kn - Kannada
  • ko - Korean
  • ky - Kirghiz, Kyrgyz
  • lb - Luxembourgish, Letzeburgesch
  • ln - Lingala
  • lt - Lithuanian
  • lv - Latvian
  • mk - Macedonian
  • ml - Malayalam
  • mr - Marathi (Marāṭhī)
  • ms - Malay
  • ne - Nepali
  • nl - Dutch
  • no - Norwegian
  • ny - Chichewa; Chewa; Nyanja
  • pa - Panjabi, Punjabi
  • pl - Polish
  • ps - Pashto, Pushto
  • pt - Portuguese
  • ro - Romanian, Moldavian, Moldovan
  • ru - Russian
  • sd - Sindhi
  • sk - Slovak
  • sl - Slovene
  • so - Somali
  • sr - Serbian
  • sv - Swedish
  • sw - Swahili
  • ta - Tamil
  • te - Telugu
  • th - Thai
  • tl - Tagalog
  • tr - Turkish
  • uk - Ukrainian
  • ur - Urdu
  • vi - Vietnamese
  • zh - Chinese
Available options:
af,
ar,
as,
az,
be,
bg,
bn,
bs,
ca,
cb,
cs,
cy,
da,
de,
el,
en,
es,
et,
fa,
fi,
fl,
fr,
ga,
gl,
gu,
ha,
he,
hi,
hr,
hu,
hy,
id,
is,
it,
ja,
jv,
ka,
kk,
kn,
ko,
ky,
lb,
ln,
lt,
lv,
mk,
ml,
mr,
ms,
ne,
nl,
no,
ny,
pa,
pl,
ps,
pt,
ro,
ru,
sd,
sk,
sl,
so,
sr,
sv,
sw,
ta,
te,
th,
tl,
tr,
uk,
ur,
vi,
zh
​
webhook_url
string<uri> | null

Webhook URL for status updates. Default is null.

Maximum string length: 200

Response

201 - application/json
​
id
string<uuid>
required
read-only
​
created_at
string<date-time>
required
read-only
​
updated_at
string<date-time>
required
read-only
​
link
string<uuid>
required

UUID of a pre-created Link used for ad generation. Create the Link using the Links API and ensure it contains at least one image.

​
video_url
string<uri>
required

URL of the reference ad video

​
video_output
string | null
required
read-only

Video output URL

​
credits_used
number
required
read-only

Credits used in this API call

​
media_job
string<uuid> | null
required
read-only
​
status
enum<string>
required
  • pending - Pending
  • in_queue - In Queue
  • running - Running
  • failed - Failed
  • done - Done
  • rejected - Rejected
Available options:
pending,
in_queue,
running,
failed,
done,
rejected
​
aspect_ratio
enum<string>
default:9x16
  • 9x16 - 9X16
  • 16x9 - 16X9
  • 1x1 - 1X1
Available options:
9x16,
16x9,
1x1
​
language

Language of the video. If null, the original language of the video is used.

  • af - Afrikaans
  • ar - Arabic
  • as - Assamese
  • az - Azerbaijani
  • be - Belarusian
  • bg - Bulgarian
  • bn - Bengali
  • bs - Bosnian
  • ca - Catalan; Valencian
  • cb - Cebuano
  • cs - Czech
  • cy - Welsh
  • da - Danish
  • de - German
  • el - Greek, Modern
  • en - English
  • es - Spanish; Castilian
  • et - Estonian
  • fa - Persian
  • fi - Finnish
  • fl - Filipino
  • fr - French
  • ga - Irish
  • gl - Galician
  • gu - Gujarati
  • ha - Hausa
  • he - Hebrew (modern)
  • hi - Hindi
  • hr - Croatian
  • hu - Hungarian
  • hy - Armenian
  • id - Indonesian
  • is - Icelandic
  • it - Italian
  • ja - Japanese
  • jv - Javanese
  • ka - Georgian
  • kk - Kazakh
  • kn - Kannada
  • ko - Korean
  • ky - Kirghiz, Kyrgyz
  • lb - Luxembourgish, Letzeburgesch
  • ln - Lingala
  • lt - Lithuanian
  • lv - Latvian
  • mk - Macedonian
  • ml - Malayalam
  • mr - Marathi (Marāṭhī)
  • ms - Malay
  • ne - Nepali
  • nl - Dutch
  • no - Norwegian
  • ny - Chichewa; Chewa; Nyanja
  • pa - Panjabi, Punjabi
  • pl - Polish
  • ps - Pashto, Pushto
  • pt - Portuguese
  • ro - Romanian, Moldavian, Moldovan
  • ru - Russian
  • sd - Sindhi
  • sk - Slovak
  • sl - Slovene
  • so - Somali
  • sr - Serbian
  • sv - Swedish
  • sw - Swahili
  • ta - Tamil
  • te - Telugu
  • th - Thai
  • tl - Tagalog
  • tr - Turkish
  • uk - Ukrainian
  • ur - Urdu
  • vi - Vietnamese
  • zh - Chinese
Available options:
af,
ar,
as,
az,
be,
bg,
bn,
bs,
ca,
cb,
cs,
cy,
da,
de,
el,
en,
es,
et,
fa,
fi,
fl,
fr,
ga,
gl,
gu,
ha,
he,
hi,
hr,
hu,
hy,
id,
is,
it,
ja,
jv,
ka,
kk,
kn,
ko,
ky,
lb,
ln,
lt,
lv,
mk,
ml,
mr,
ms,
ne,
nl,
no,
ny,
pa,
pl,
ps,
pt,
ro,
ru,
sd,
sk,
sl,
so,
sr,
sv,
sw,
ta,
te,
th,
tl,
tr,
uk,
ur,
vi,
zh
​
webhook_url
string<uri> | null

Webhook URL for status updates. Default is null.

Maximum string length: 200