Skip to main content
GET
/
api
/
link_to_videos
/
{id}
/
cURL
curl --request GET \
  --url https://api.creatify.ai/api/link_to_videos/{id}/ \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "target_platform": "<string>",
  "target_audience": "<string>",
  "language": "ar",
  "video_length": 15,
  "aspect_ratio": "9x16",
  "script_style": "BenefitsV2",
  "visual_style": "AvatarBubbleTemplate",
  "override_avatar": "<string>",
  "override_voice": "<string>",
  "override_script": "<string>",
  "background_music_url": "<string>",
  "background_music_volume": 0.5,
  "voiceover_volume": 0.5,
  "webhook_url": "<string>",
  "link": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "media_job": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "<string>",
  "failed_reason": "<string>",
  "is_hidden": true,
  "video_output": "<string>",
  "video_thumbnail": "<string>",
  "outputs": [
    {
      "media_job": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "visual_style": "AvatarBubbleTemplate",
      "aspect_ratio": "9x16",
      "duration": 123,
      "video_output": "<string>",
      "video_thumbnail": "<string>",
      "status": "pending",
      "progress": 123,
      "failed_reason": "<string>"
    }
  ],
  "credits_used": 123,
  "duration": 123,
  "progress": "<string>",
  "no_background_music": true,
  "no_caption": true,
  "no_emotion": true,
  "no_cta": true,
  "no_stock_broll": true,
  "preview": "<string>",
  "previews": [
    {
      "media_job": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "visual_style": "AvatarBubbleTemplate",
      "aspect_ratio": "9x16",
      "url": "<string>",
      "editor_url": "<string>",
      "duration": 123
    }
  ],
  "editor_url": "<string>",
  "caption_style": "normal-black",
  "caption_offset_x": "<string>",
  "caption_offset_y": "<string>",
  "caption_setting": {
    "style": "normal-black",
    "offset": {
      "x": 0,
      "y": 0.4
    },
    "font_family": "Montserrat",
    "font_size": 123,
    "font_style": "font-bold",
    "background_color": "<string>",
    "text_color": "<string>",
    "highlight_text_color": "<string>",
    "max_width": 123,
    "line_height": 123,
    "text_shadow": "<string>",
    "hidden": false
  },
  "model_version": "standard",
  "visual_styles": [
    "AvatarBubbleTemplate"
  ],
  "aspect_ratios": [
    "9x16"
  ]
}

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.

Path Parameters

​
id
string<uuid>
required

A UUID string identifying this Link to Video.

Response

200 - application/json
​
id
string<uuid>
required
​
link
string<uuid>
required

Link associated with the video.

​
media_job
string<uuid> | null
required

Media job associated with the video. Default is null.

​
status
string
required
​
failed_reason
string | null
required

Reason for failure. Default is null.

​
is_hidden
boolean
required
​
video_output
string<uri>
required

Generated Video URL

​
video_thumbnail
string<uri>
required

Generated Video Thumbnail URL

​
outputs
object[]
required

List of outputs

​
credits_used
integer
required

Credits used in this API call

​
duration
integer
required

Duration of the video in seconds

​
progress
string
required
​
preview
string<uri>
required

Preview URL

​
previews
object[]
required

List of previews

​
editor_url
string<uri>
required

Editor URL for the video. Expires in 24 hours. Available only if your API account has API editor access enabled.

​
visual_styles
enum<string>[]
required
Minimum length: 1
​
name
string | null

Name of the video. Default is null.

Maximum length: 255
​
target_platform
string

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

Maximum length: 255
​
target_audience
string | null

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

​
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
​
video_length
enum<integer>

Length of the video in seconds. Default is 15.

  • 15 - 15
  • 30 - 30
  • 60 - 60
Available options:
15,
30,
60
​
aspect_ratio
  • 9x16 - 9X16
  • 16x9 - 16X9
  • 1x1 - 1X1
Available options:
9x16,
16x9,
1x1
​
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
  • NegativeHook - Don’t Use This If You Want...
  • NumberOneHook - The #1 Hack You Need
  • EverWonderHook - Ever Wonder Why?
  • SecretHook - Wish I Could Keep This Secret
  • WhatHappensHook - What Happens If You Try This?
  • AnyoneElseHook - That One Thing We All Have
  • AmazedHook - Still Amazed by This
  • 2025Hook - Hack 2025 Like This
  • HateMeHook - They’ll Hate Me for This
  • ResponseBubbleTextOverlay - Response bubble
  • HeyAlgorithmHook - Hey Algorithm
  • CannotBelieveHook - Cannot Believe This
  • FinallyConfidentHook - Finally Confident
  • PremiumFeelingHook - Premium Feeling
  • FirstTimeFullHook - First Time Full
  • LongLineReasonHook - Long Line Reason
  • MissingOutAlertHook - Missing Out Alert
  • BetterTodayVersionHook - Better Today Version
  • BigHappeningHook - Big Happening
  • PriceDropRegretHook - Price Drop Regret
  • GroupBuyFrustrationHook - Group Buy Frustration
  • StopAffordExcuseHook - Stop Afford Excuse
  • LifeTooShortDiscountHook - Life Too Short Discount
  • HugePriceDropRushHook - Huge Price Drop Rush
  • PriceCouldGoLowerHook - Price Could Go Lower
  • StillFullPriceHook - Still Full Price
  • SecretDiscountShareHook - Secret Discount Share
  • VoucherSavingsAlertHook - Voucher Savings Alert
  • CouponDiscoveryRegretHook - Coupon Discovery Regret
  • BestDealEverHook - Best Deal Ever
  • DIY - DIY
Available options:
BenefitsV2,
BrandStoryV2,
CallToActionV2,
DiscoveryWriter,
DontWorryWriter,
EmotionalWriter,
GenzWriter,
HowToV2,
LetMeShowYouWriter,
MotivationalWriter,
ProblemSolutionV2,
ProblemSolutionWriter,
ProductHighlightsV2,
ProductLifestyleV2,
ResponseBubbleWriter,
SpecialOffersV2,
StoryTimeWriter,
ThreeReasonsWriter,
TrendingTopicsV2,
NegativeHook,
NumberOneHook,
EverWonderHook,
SecretHook,
WhatHappensHook,
AnyoneElseHook,
AmazedHook,
2025Hook,
HateMeHook,
ResponseBubbleTextOverlay,
HeyAlgorithmHook,
CannotBelieveHook,
FinallyConfidentHook,
PremiumFeelingHook,
FirstTimeFullHook,
LongLineReasonHook,
MissingOutAlertHook,
BetterTodayVersionHook,
BigHappeningHook,
PriceDropRegretHook,
GroupBuyFrustrationHook,
StopAffordExcuseHook,
LifeTooShortDiscountHook,
HugePriceDropRushHook,
PriceCouldGoLowerHook,
StillFullPriceHook,
SecretDiscountShareHook,
VoucherSavingsAlertHook,
CouponDiscoveryRegretHook,
BestDealEverHook,
DIY
​
visual_style
enum<string>
default:AvatarBubbleTemplate

Visual style of the video. Default is AvatarBubbleTemplate.

  • AvatarBubbleTemplate: Avatar Bubble (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • DramaticTemplate: Dramatic (Applicable to aspect_ratio 9x16)
  • DynamicGreenScreenEffect: Dynamic Green Screen Effect (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • DynamicProductTemplate: Product (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • DynamicResponseBubbleTemplate: Response Bubble (Applicable to aspect_ratio 9x16)
  • EnhancedVanillaTemplate: Dynamic Vanilla (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • FeatureHighlightTemplate: Feature Highlight (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • FullScreenTemplate: Full Screen (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • FullScreenV2Template: Full Screen V2 (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • GreenScreenEffectTemplate: Green Screen Effect (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • MotionCardsTemplate: Motion Cards (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • OverCardsTemplate: Over Cards (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • QuickFrameTemplate: Quick Frame (Applicable to aspect_ratio 16x9)
  • QuickTransitionTemplate: Quick Transition (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • ScribbleTemplate: Scribble (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • SideBySideTemplate: Side by Side (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • SimpleAvatarOverlayTemplate: Product Presenter (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • TopBottomTemplate: Top & Bottom (Applicable to aspect_ratio 9x16, 1x1)
  • TwitterFrameTemplate: Twitter Frame (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • VanillaTemplate: Vanilla (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • VlogTemplate: Vlog (Applicable to aspect_ratio 9x16)
  • LegoVisualEmotional: Emotional (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • LegoVisualCutePets: Cute Pets (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • LegoVisualAvatarFocusIntro: Avatar Focus Intro (Applicable to aspect_ratio 9x16, 16x9, 1x1)
  • LegoScriptNegativeHook: Don’t Use This If You Want... (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptNumberOneHook: The #1 Hack You Need (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptEverWonderHook: Ever Wonder Why? (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptSecretHook: Wish I Could Keep This Secret (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptWhatHappensHook: What Happens If You Try This? (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptAnyoneElseHook: That One Thing We All Have (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptAmazedHook: Still Amazed by This (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScript2025Hook: Hack 2025 Like This (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptHateMeHook: They’ll Hate Me for This (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptResponseBubbleTextOverlay: Response bubble (Applicable to aspect_ratio 9x16, 1x1)
  • LegoScriptHeyAlgorithmHook: Hey Algorithm (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptCannotBelieveHook: Cannot Believe This (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptFinallyConfidentHook: Finally Confident (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptPremiumFeelingHook: Premium Feeling (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptFirstTimeFullHook: First Time Full (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptLongLineReasonHook: Long Line Reason (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptMissingOutAlertHook: Missing Out Alert (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptBetterTodayVersionHook: Better Today Version (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptBigHappeningHook: Big Happening (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptPriceDropRegretHook: Price Drop Regret (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptGroupBuyFrustrationHook: Group Buy Frustration (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptStopAffordExcuseHook: Stop Afford Excuse (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptLifeTooShortDiscountHook: Life Too Short Discount (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptHugePriceDropRushHook: Huge Price Drop Rush (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptPriceCouldGoLowerHook: Price Could Go Lower (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptStillFullPriceHook: Still Full Price (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptSecretDiscountShareHook: Secret Discount Share (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptVoucherSavingsAlertHook: Voucher Savings Alert (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptCouponDiscoveryRegretHook: Coupon Discovery Regret (Applicable to aspect_ratio 9x16, 1x1, 16x9)
  • LegoScriptBestDealEverHook: Best Deal Ever (Applicable to aspect_ratio 9x16, 1x1, 16x9)
Available options:
AvatarBubbleTemplate,
DramaticTemplate,
DynamicGreenScreenEffect,
DynamicProductTemplate,
DynamicResponseBubbleTemplate,
EnhancedVanillaTemplate,
FeatureHighlightTemplate,
FullScreenTemplate,
FullScreenV2Template,
GreenScreenEffectTemplate,
MotionCardsTemplate,
OverCardsTemplate,
QuickFrameTemplate,
QuickTransitionTemplate,
ScribbleTemplate,
SideBySideTemplate,
SimpleAvatarOverlayTemplate,
TopBottomTemplate,
TwitterFrameTemplate,
VanillaTemplate,
VlogTemplate,
LegoVisualEmotional,
LegoVisualCutePets,
LegoVisualAvatarFocusIntro,
LegoScriptNegativeHook,
LegoScriptNumberOneHook,
LegoScriptEverWonderHook,
LegoScriptSecretHook,
LegoScriptWhatHappensHook,
LegoScriptAnyoneElseHook,
LegoScriptAmazedHook,
LegoScript2025Hook,
LegoScriptHateMeHook,
LegoScriptResponseBubbleTextOverlay,
LegoScriptHeyAlgorithmHook,
LegoScriptCannotBelieveHook,
LegoScriptFinallyConfidentHook,
LegoScriptPremiumFeelingHook,
LegoScriptFirstTimeFullHook,
LegoScriptLongLineReasonHook,
LegoScriptMissingOutAlertHook,
LegoScriptBetterTodayVersionHook,
LegoScriptBigHappeningHook,
LegoScriptPriceDropRegretHook,
LegoScriptGroupBuyFrustrationHook,
LegoScriptStopAffordExcuseHook,
LegoScriptLifeTooShortDiscountHook,
LegoScriptHugePriceDropRushHook,
LegoScriptPriceCouldGoLowerHook,
LegoScriptStillFullPriceHook,
LegoScriptSecretDiscountShareHook,
LegoScriptVoucherSavingsAlertHook,
LegoScriptCouponDiscoveryRegretHook,
LegoScriptBestDealEverHook
​
override_avatar
string | null

Override avatar for the video. Default is null.

Maximum length: 255
​
override_voice
string | null

Override voice for the video. Default is null.

Maximum length: 255
​
override_script
string | null

Override script for the video. Default is null.

​
background_music_url
string<uri> | 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
​
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<uri> | null

Webhook URL for status updates. Default is null.

Maximum length: 200
​
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_emotion
boolean

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

​
no_cta
boolean

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

​
no_stock_broll
boolean

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

​
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
  • comic-shadow - COMIC_SHADOW
  • clean-bold - CLEAN_BOLD
  • soft-pill - SOFT_PILL
  • underline-bold - UNDERLINE_BOLD
  • classic-duo - CLASSIC_DUO
  • hand-script - HAND_SCRIPT
  • button-glow - BUTTON_GLOW
  • emboss-outline - EMBOSS_OUTLINE
  • standard-bold - STANDARD_BOLD
  • outlined-text - OUTLINED_TEXT
  • quiet-serif - QUIET_SERIF
  • editorial-clean - EDITORIAL_CLEAN
  • shout-block - SHOUT_BLOCK
  • word-flash - WORD_FLASH
  • promo-punch - PROMO_PUNCH
  • light-word - LIGHT_WORD
  • tagline-bold - TAGLINE_BOLD
  • glow-speak - GLOW_SPEAK
  • black-block - BLACK_BLOCK
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,
comic-shadow,
clean-bold,
soft-pill,
underline-bold,
classic-duo,
hand-script,
button-glow,
emboss-outline,
standard-bold,
outlined-text,
quiet-serif,
editorial-clean,
shout-block,
word-flash,
promo-punch,
light-word,
tagline-bold,
glow-speak,
black-block
​
caption_offset_x
string<decimal> | 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<decimal> | 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

​
model_version
enum<string>

Model version for the avatar, 'standard', 'aurora_v1' or 'aurora_v1_fast'. Default is 'standard'. Standard model costs 5 credits per 30 seconds video, Aurora_v1 model costs 20 credits per 15 seconds video, and Aurora_v1_fast renders faster with lower quality for 10 credits per 15 seconds video.

  • standard - Standard
  • aurora_v1 - Aurora v1
  • aurora_v1_fast - Aurora v1 Fast
Available options:
standard,
aurora_v1,
aurora_v1_fast
​
aspect_ratios
enum<string>[] | null
⌘I