POST
/
api
/
link_to_videos

​
About Request Data Structure of Webhook

When using ‘create video from link’ API, if the ‘webhook_url’ is passed in the parameters, we will initiate a POST request to the webhook_url when the task succeeds or fails, with the following content:

{
    'id': 'string',
    'status': 'string',
    'failed_reason': 'string',
    'video_output': 'string',
}

Arguments:

  • id (string): The unique identifier of the job
  • status (string): The status of the job. Possible values are pending, in_queue, running, failed, done
  • failed_reason (string): The reason of the failure if the job failed
  • video_output (string): The URL of the video if the job is done

Note: We might send multiple requests for status changes.

​
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

201 - 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
DYOA APIGet video result