POST
/
api
/
link_to_videos
/
preview

​
About preview Field in the Response

The preview field provides a link to preview the video. This link allows you to preview the video before rendering it, you can put it in an iframe to show the video in your application. Example: The preview field in the response will look like this:

"https://video.creatify.ai/preview?layout=videos/20240808/abd7ac2e-471a-4f0c-b2b2-a4e6580c61f9.json"

​
About override_avatar parameter

When using ‘create video from link’ API, if the ‘override_avatar’ (avatar_id is passed in the parameters, we will use it as the avatar of the video. If the ‘override_avatar’ is not passed, we will use the matched avatar for the video.

avatar_id is the unique identifier of an avatar. You can get the avatar_id by calling the Get avatar endpoint.

​
About override_voice parameter

When using ‘create video from link’ API, if the ‘override_voice’ is passed in the parameters, we will use it for the voiceover of the video. If the ‘override_voice’ is not passed, we’ll use the matched voice (from the avatar) for the video.

voice_id is the unique identifier of the voice. You can get the voice_id by calling the Get voices interface.

Tips: foreach voice has multiple accents, you can choose one from the accents as the voice of the video.

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
required

Link associated with the video.

​
aspect_ratio
enum<string>

Aspect ratio of the video. Default is '16x9'.

  • 16x9 - 16x9
  • 1x1 - 1x1
  • 9x16 - 9x16
Available options:
16x9,
1x1,
9x16
​
background_music_url
string | null

Background music URL for the video. Default is null, video will use random music.

Maximum length: 255
​
background_music_volume
number | null

Volume of the background music, ranging from 0.0 to 1.0. Default is null, video will use default music volume of visual_style.

Required range: 0 < x < 1
​
caption_offset_x
string | null

Deprecated, use offset in caption_setting instead. Caption offset x is horizontally relative to the center of the canvas in percentage, range from -0.5 to 0.5. Default is null, video with default caption position of visual_style.

​
caption_offset_y
string | null

Deprecated, use offset in caption_setting instead. Caption offset y is vertically relative to the center of the canvas in percentage, range from -0.5 to 0.5. Default is null, video with default caption position of visual_style.

​
caption_setting
object

Caption setting, default null and default caption setting will be used

​
caption_style

Deprecated, use style in caption_setting instead. Caption style for the video. Default is 'normal-black'.

  • normal-black - NORMAL_BLACK
  • normal-white - NORMAL_WHITE
  • normal-red - NORMAL_RED
  • normal-blue - NORMAL_BLUE
  • neo - NEO
  • brick - BRICK
  • frenzy - FRENZY
  • verana - VERANA
  • mustard - MUSTARD
  • glow - GLOW
  • mint - MINT
  • coolers - COOLERS
  • bilo - BILO
  • toons - TOONS
  • deep-blue - DEEP_BLUE
  • mystique - MYSTIQUE
  • caution - CAUTION
  • duality - DUALITY
Available options:
normal-black,
normal-white,
normal-red,
normal-blue,
neo,
brick,
frenzy,
verana,
mustard,
glow,
mint,
coolers,
bilo,
toons,
deep-blue,
mystique,
caution,
duality
​
language
enum<string>

Language of the video. Default is 'en'.

  • ar - Arabic
  • bg - Bulgarian
  • cs - Czech
  • da - Danish
  • de - German
  • el - Greek, Modern
  • en - English
  • es - Spanish; Castilian
  • fi - Finnish
  • fr - French
  • hi - Hindi
  • hr - Croatian
  • id - Indonesian
  • it - Italian
  • ja - Japanese
  • ko - Korean
  • ms - Malay
  • nl - Dutch
  • pl - Polish
  • pt - Portuguese
  • ro - Romanian, Moldavian, Moldovan
  • ru - Russian
  • sk - Slovak
  • sv - Swedish
  • ta - Tamil
  • tl - Tagalog
  • tr - Turkish
  • uk - Ukrainian
  • zh - Chinese
Available options:
ar,
bg,
cs,
da,
de,
el,
en,
es,
fi,
fr,
hi,
hr,
id,
it,
ja,
ko,
ms,
nl,
pl,
pt,
ro,
ru,
sk,
sv,
ta,
tl,
tr,
uk,
zh
​
name
string | null

Name of the video. Default is null.

Maximum length: 255
​
no_background_music
boolean

No background music for the video. Default is false, video with background music.

​
no_caption
boolean

No caption for the video. Default is false, video with caption.

​
no_cta
boolean

No call to action for the video. Default is false, video with call to action.

​
no_emotion
boolean

No emotion for the video. Default is false, video with emotion.

​
no_stock_broll
boolean

No stock broll for the video. Default is false, video with stock broll.

​
override_avatar
string | null

Override avatar for the video. Default is null.

Maximum length: 255
​
override_script
string | null

Override script for the video. Default is null.

​
override_voice
string | null

Override voice for the video. Default is null.

Maximum length: 255
​
script_style
enum<string>

Script style of the video. Default is DiscoveryWriter.

  • BenefitsV2 - Benefits
  • BrandStoryV2 - Brand Story
  • CallToActionV2 - Call To Action
  • DiscoveryWriter - Discovery
  • DontWorryWriter - Don't Worry
  • EmotionalWriter - Emotional
  • GenzWriter - Gen Z
  • HowToV2 - How To
  • LetMeShowYouWriter - Let Me Show You
  • MotivationalWriter - Motivational
  • ProblemSolutionV2 - Problem Solution
  • ProblemSolutionWriter - Problem-Solution
  • ProductHighlightsV2 - Product Highlights
  • ProductLifestyleV2 - Product Lifestyle
  • ResponseBubbleWriter - Response Bubble
  • SpecialOffersV2 - Special Offers
  • StoryTimeWriter - Storytime
  • ThreeReasonsWriter - 3 Reasons Why
  • TrendingTopicsV2 - Trending Topics
  • DIY - DIY
Available options:
BenefitsV2,
BrandStoryV2,
CallToActionV2,
DiscoveryWriter,
DontWorryWriter,
EmotionalWriter,
GenzWriter,
HowToV2,
LetMeShowYouWriter,
MotivationalWriter,
ProblemSolutionV2,
ProblemSolutionWriter,
ProductHighlightsV2,
ProductLifestyleV2,
ResponseBubbleWriter,
SpecialOffersV2,
StoryTimeWriter,
ThreeReasonsWriter,
TrendingTopicsV2,
DIY
​
target_audience
string | null

Target audience for the video. Default is 'young adults'.

​
target_platform
string

Target platform for the video. Default is 'tiktok'.

Maximum length: 255
​
video_length
enum<integer>

Length of the video in seconds. Default is 15.

  • 15 - 15
  • 30 - 30
  • 60 - 60
Available options:
15,
30,
60
​
visual_style
enum<string>

Visual style of the video. Default is AvatarBubbleTemplate.

  • AvatarBubbleTemplate - Avatar Bubble
  • DramaticTemplate - Dramatic
  • DynamicProductTemplate - Product
  • DynamicResponseBubbleTemplate - Response Bubble
  • EnhancedVanillaTemplate - Dynamic Vanilla
  • FullScreenTemplate - Full Screen
  • FullScreenV2Template - Full Screen V2
  • GreenScreenEffectTemplate - Green Screen Effect
  • LegoTemplate - Lego
  • MotionCardsTemplate - Motion Cards
  • OverCardsTemplate - Over Cards
  • QuickTransitionTemplate - Quick Transition
  • ScribbleTemplate - Scribble
  • SideBySideTemplate - Side by Side
  • SimpleAvatarOverlayTemplate - Product Presenter
  • TopBottomTemplate - Top & Bottom
  • TwitterFrameTemplate - Twitter Frame
  • VanillaTemplate - Vanilla
  • VlogTemplate - Vlog
Available options:
AvatarBubbleTemplate,
DramaticTemplate,
DynamicProductTemplate,
DynamicResponseBubbleTemplate,
EnhancedVanillaTemplate,
FullScreenTemplate,
FullScreenV2Template,
GreenScreenEffectTemplate,
LegoTemplate,
MotionCardsTemplate,
OverCardsTemplate,
QuickTransitionTemplate,
ScribbleTemplate,
SideBySideTemplate,
SimpleAvatarOverlayTemplate,
TopBottomTemplate,
TwitterFrameTemplate,
VanillaTemplate,
VlogTemplate
​
voiceover_volume
number | null

Volume of the voiceover, ranging from 0.0 to 1.0. Default is null, video will use default voiceover volume of visual_style.

Required range: 0 < x < 1
​
webhook_url
string | null

Webhook URL for status updates. Default is null.

Maximum length: 200

Response

200 - application/json
​
credits_used
integer
required

Credits used in this api call

​
failed_reason
string | null
required

Reason for failure. Default is null.

​
id
string
required
​
is_hidden
boolean
required
​
link
string
required

Link associated with the video.

​
media_job
string | null
required

Media job associated with the video. Default is null.

​
preview
string | null
required
​
progress
string
required
​
status
string
required
​
video_output
string | null
required
​
aspect_ratio
enum<string>

Aspect ratio of the video. Default is '16x9'.

  • 16x9 - 16x9
  • 1x1 - 1x1
  • 9x16 - 9x16
Available options:
16x9,
1x1,
9x16
​
background_music_url
string | null

Background music URL for the video. Default is null, video will use random music.

Maximum length: 255
​
background_music_volume
number | null

Volume of the background music, ranging from 0.0 to 1.0. Default is null, video will use default music volume of visual_style.

Required range: 0 < x < 1
​
caption_offset_x
string | null

Deprecated, use offset in caption_setting instead. Caption offset x is horizontally relative to the center of the canvas in percentage, range from -0.5 to 0.5. Default is null, video with default caption position of visual_style.

​
caption_offset_y
string | null

Deprecated, use offset in caption_setting instead. Caption offset y is vertically relative to the center of the canvas in percentage, range from -0.5 to 0.5. Default is null, video with default caption position of visual_style.

​
caption_setting
object

Caption setting, default null and default caption setting will be used

​
caption_style

Deprecated, use style in caption_setting instead. Caption style for the video. Default is 'normal-black'.

  • normal-black - NORMAL_BLACK
  • normal-white - NORMAL_WHITE
  • normal-red - NORMAL_RED
  • normal-blue - NORMAL_BLUE
  • neo - NEO
  • brick - BRICK
  • frenzy - FRENZY
  • verana - VERANA
  • mustard - MUSTARD
  • glow - GLOW
  • mint - MINT
  • coolers - COOLERS
  • bilo - BILO
  • toons - TOONS
  • deep-blue - DEEP_BLUE
  • mystique - MYSTIQUE
  • caution - CAUTION
  • duality - DUALITY
Available options:
normal-black,
normal-white,
normal-red,
normal-blue,
neo,
brick,
frenzy,
verana,
mustard,
glow,
mint,
coolers,
bilo,
toons,
deep-blue,
mystique,
caution,
duality
​
language
enum<string>

Language of the video. Default is 'en'.

  • ar - Arabic
  • bg - Bulgarian
  • cs - Czech
  • da - Danish
  • de - German
  • el - Greek, Modern
  • en - English
  • es - Spanish; Castilian
  • fi - Finnish
  • fr - French
  • hi - Hindi
  • hr - Croatian
  • id - Indonesian
  • it - Italian
  • ja - Japanese
  • ko - Korean
  • ms - Malay
  • nl - Dutch
  • pl - Polish
  • pt - Portuguese
  • ro - Romanian, Moldavian, Moldovan
  • ru - Russian
  • sk - Slovak
  • sv - Swedish
  • ta - Tamil
  • tl - Tagalog
  • tr - Turkish
  • uk - Ukrainian
  • zh - Chinese
Available options:
ar,
bg,
cs,
da,
de,
el,
en,
es,
fi,
fr,
hi,
hr,
id,
it,
ja,
ko,
ms,
nl,
pl,
pt,
ro,
ru,
sk,
sv,
ta,
tl,
tr,
uk,
zh
​
name
string | null

Name of the video. Default is null.

Maximum length: 255
​
no_background_music
boolean

No background music for the video. Default is false, video with background music.

​
no_caption
boolean

No caption for the video. Default is false, video with caption.

​
no_cta
boolean

No call to action for the video. Default is false, video with call to action.

​
no_emotion
boolean

No emotion for the video. Default is false, video with emotion.

​
no_stock_broll
boolean

No stock broll for the video. Default is false, video with stock broll.

​
override_avatar
string | null

Override avatar for the video. Default is null.

Maximum length: 255
​
override_script
string | null

Override script for the video. Default is null.

​
override_voice
string | null

Override voice for the video. Default is null.

Maximum length: 255
​
script_style
enum<string>

Script style of the video. Default is DiscoveryWriter.

  • BenefitsV2 - Benefits
  • BrandStoryV2 - Brand Story
  • CallToActionV2 - Call To Action
  • DiscoveryWriter - Discovery
  • DontWorryWriter - Don't Worry
  • EmotionalWriter - Emotional
  • GenzWriter - Gen Z
  • HowToV2 - How To
  • LetMeShowYouWriter - Let Me Show You
  • MotivationalWriter - Motivational
  • ProblemSolutionV2 - Problem Solution
  • ProblemSolutionWriter - Problem-Solution
  • ProductHighlightsV2 - Product Highlights
  • ProductLifestyleV2 - Product Lifestyle
  • ResponseBubbleWriter - Response Bubble
  • SpecialOffersV2 - Special Offers
  • StoryTimeWriter - Storytime
  • ThreeReasonsWriter - 3 Reasons Why
  • TrendingTopicsV2 - Trending Topics
  • DIY - DIY
Available options:
BenefitsV2,
BrandStoryV2,
CallToActionV2,
DiscoveryWriter,
DontWorryWriter,
EmotionalWriter,
GenzWriter,
HowToV2,
LetMeShowYouWriter,
MotivationalWriter,
ProblemSolutionV2,
ProblemSolutionWriter,
ProductHighlightsV2,
ProductLifestyleV2,
ResponseBubbleWriter,
SpecialOffersV2,
StoryTimeWriter,
ThreeReasonsWriter,
TrendingTopicsV2,
DIY
​
target_audience
string | null

Target audience for the video. Default is 'young adults'.

​
target_platform
string

Target platform for the video. Default is 'tiktok'.

Maximum length: 255
​
video_length
enum<integer>

Length of the video in seconds. Default is 15.

  • 15 - 15
  • 30 - 30
  • 60 - 60
Available options:
15,
30,
60
​
visual_style
enum<string>

Visual style of the video. Default is AvatarBubbleTemplate.

  • AvatarBubbleTemplate - Avatar Bubble
  • DramaticTemplate - Dramatic
  • DynamicProductTemplate - Product
  • DynamicResponseBubbleTemplate - Response Bubble
  • EnhancedVanillaTemplate - Dynamic Vanilla
  • FullScreenTemplate - Full Screen
  • FullScreenV2Template - Full Screen V2
  • GreenScreenEffectTemplate - Green Screen Effect
  • LegoTemplate - Lego
  • MotionCardsTemplate - Motion Cards
  • OverCardsTemplate - Over Cards
  • QuickTransitionTemplate - Quick Transition
  • ScribbleTemplate - Scribble
  • SideBySideTemplate - Side by Side
  • SimpleAvatarOverlayTemplate - Product Presenter
  • TopBottomTemplate - Top & Bottom
  • TwitterFrameTemplate - Twitter Frame
  • VanillaTemplate - Vanilla
  • VlogTemplate - Vlog
Available options:
AvatarBubbleTemplate,
DramaticTemplate,
DynamicProductTemplate,
DynamicResponseBubbleTemplate,
EnhancedVanillaTemplate,
FullScreenTemplate,
FullScreenV2Template,
GreenScreenEffectTemplate,
LegoTemplate,
MotionCardsTemplate,
OverCardsTemplate,
QuickTransitionTemplate,
ScribbleTemplate,
SideBySideTemplate,
SimpleAvatarOverlayTemplate,
TopBottomTemplate,
TwitterFrameTemplate,
VanillaTemplate,
VlogTemplate
​
voiceover_volume
number | null

Volume of the voiceover, ranging from 0.0 to 1.0. Default is null, video will use default voiceover volume of visual_style.

Required range: 0 < x < 1
​
webhook_url
string | null

Webhook URL for status updates. Default is null.

Maximum length: 200
Get video historyRender video