Create a AI Shorts task

API that converts text to viral video. Creating a video through this endpoint costs 5 credits for every 30 seconds.

POST /api/ai_shorts

Try it

cURL

cURL

curl --request POST \
  --url https://api.creatify.ai/api/ai_shorts/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "aspect_ratio": "9x16",
  "script": "<string>",
  "style": "4K realistic",
  "accent": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "caption_setting": {
    "style": "normal-black",
    "offset": {
      "x": 0,
      "y": 0.4
    },
    "font_family": "Montserrat",
    "font_size": 70,
    "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
  },
  "background_music_url": "<string>",
  "background_music_volume": 0.5,
  "voiceover_volume": 0.5,
  "webhook_url": "<string>"
}
'

201

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "pending",
  "failed_reason": "<string>",
  "video_output": "<string>",
  "preview": "<string>",
  "editor_url": "<string>",
  "is_hidden": true,
  "progress": 123,
  "credits_used": 123,
  "duration": 123,
  "media_job": "<string>",
  "permission_type": "private",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "user": 123,
  "workspace": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "script": "<string>",
  "aspect_ratio": "9x16",
  "style": "4K realistic",
  "created_from_api": true,
  "caption_setting": "<unknown>",
  "background_music_url": "<string>",
  "background_music_volume": 0.5,
  "voiceover_volume": 0.5,
  "webhook_url": "<string>",
  "brand": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "accent": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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

aspect_ratio · enum<string> · required

• 9x16 - 9X16
• 16x9 - 16X9
• 1x1 - 1X1

Available options: 9x16, 16x9, 1x1

script · string · required

style · enum<string> · required

• 4K realistic - _4K_REALISTIC
• 3D - _3D
• Cinematic - CINEMATIC
• Cartoonish - CARTOONISH
• Line art - LINE_ART
• Pixel art - PIXEL_ART
• Mysterious - MYSTERIOUS
• Steam punk - STEAM_PUNK
• Collage - COLLAGE
• Kawaii - KAWAII

Available options: 4K realistic, 3D, Cinematic, Cartoonish, Line art, Pixel art, Mysterious, Steam punk, Collage, Kawaii

accent · string<uuid> | null

Accent to be used for the video, default null and default voice will be used

caption_setting · object

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

Show child attributes

caption_setting. style · enum<string> · default: normal-black

Caption style

• 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_setting. offset · object

Caption offset

Show child attributes

caption_setting.offset. x · number<double> · default: 0

X offset for the caption.

caption_setting.offset. y · number<double> · default: 0.4

Y offset for the caption.

caption_setting. font_family · enum<string> · default: Montserrat

Font family

• Montserrat - Montserrat
• Jockey One - JockeyOne
• Lilita One - LilitaOne
• Mclaren - Mclaren
• Corben - Corben
• Dela Gothic One - DelaGothicOne
• Comfortaa - Comfortaa
• Luckiest Guy - LuckiestGuy
• Quantico - Quantico
• Poppins - Poppins

Available options: Montserrat, Jockey One, Lilita One, Mclaren, Corben, Dela Gothic One, Comfortaa, Luckiest Guy, Quantico, Poppins

caption_setting. font_size · integer · default: 70

Font size

caption_setting. font_style

Font style

• font-bold - BOLD
• italic - ITALIC
• underline - UNDERLINE

Available options: font-bold, italic, underline

caption_setting. background_color · string | null

Caption background color, hex color with an alpha channel: #RRGGBBAA.

caption_setting. text_color · string | null

Caption text color, hex color with an alpha channel: #RRGGBBAA.

caption_setting. highlight_text_color · string | null

Caption highlight color for the word currently being spoken, hex color with an alpha channel: #RRGGBBAA.

caption_setting. max_width · integer | null

Caption max width in px

caption_setting. line_height · number<double> | null

Caption line height

caption_setting. text_shadow · string | null

Caption text shadow

caption_setting. hidden · boolean · default: false

Hide caption

background_music_url · string<uri> | null

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

Maximum string length: 255

background_music_volume · number<double> | 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<double> | 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 string length: 200

Response

201 - application/json

id · string<uuid> · required

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

failed_reason · string · required

Failed reason

video_output · string | null · required

Video output URL

preview · string | null · required

Preview URL

editor_url · string | null · required

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

is_hidden · boolean · required

Is the video hidden in the website projects page

progress · number<double> · required

Progress of the job

credits_used · integer · required

Credits used in this API call

duration · integer · required

Duration of the video in seconds

media_job · string | null · required

permission_type · enum<string> · required

• private - Private
• workspace - Workspace
• public - Public

Available options: private, workspace, public

created_at · string<date-time> · required

updated_at · string<date-time> · required

user · integer | null · required

workspace · string<uuid> | null · required

name · string

Maximum string length: 255

script · string | null

Text to be converted to video

aspect_ratio

Aspect ratio of the video

• 9x16 - 9X16
• 16x9 - 16X9
• 1x1 - 1X1

Available options: 9x16, 16x9, 1x1

style

Style to be used for the video

• 4K realistic - _4K_REALISTIC
• 3D - _3D
• Cinematic - CINEMATIC
• Cartoonish - CARTOONISH
• Line art - LINE_ART
• Pixel art - PIXEL_ART
• Mysterious - MYSTERIOUS
• Steam punk - STEAM_PUNK
• Collage - COLLAGE
• Kawaii - KAWAII

Available options: 4K realistic, 3D, Cinematic, Cartoonish, Line art, Pixel art, Mysterious, Steam punk, Collage, Kawaii

created_from_api · boolean

Flow is created from api or not

caption_setting · any | null

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

background_music_url · string<uri> | null

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

Maximum string length: 255

background_music_volume · number<double> | 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<double> | 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 string length: 200

brand · string<uuid> | null

accent · string<uuid> | null

Accent to be used for the video, default null and default voice will be used