​
Introduction

Transform any link into a short video ad with our API! Just give us the URL and we’ll gather all the information we need from the page. You can then customize your video to suit your target audience, language, script style, and visual style. It’s as simple as that!

​
Quickstart

​
Prerequisite

  • You need a creatify.ai account with API access.
  • You need to go through the Get your API key

Example request, replace your-api-id and you-api-key with your actual API ID and API Key.

curl --request POST \
  --url https://api.creatify.ai/api/links/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: you-api-key' \
  --data '{
  "url": "https://creatify.ai"
}'

Response:

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "url": "<string>",
  "link": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "url": "<string>",
    "title": "<string>",
    "description": "<string>",
    "image_urls": [],
    "video_urls": [],
    "reviews": "<any>",
    "logo_url": "<string>"
  }
}

The id 3c90c3cc-0d44-4b50-8888-8dd25736052a is the link id. You will use this id to create a video from here.

  • It’s useful to provide at least a logo url - which will result as a CTA in the end of the video.
  • It’s also useful to remove low quality image/video urls from the scraped result to improve quality of the final video.
  • If you have specific message (e.g highlight certain feature) to deliver, you can also update the description by highlighting the feature.

You can update the link with the following request.

curl --request PUT \
  --url https://api.creatify.ai/api/links/{id}/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: you-api-key' \
  --data '{
  "url": "<string>",
  "title": "<string>",
  "description": "<string>",
  "image_urls": [
    "<string>"
  ],
  "video_urls": [
    "<string>"
  ],
  "reviews": "<any>",
  "logo_url": "<string>"
}'

Please refer to the Create video from link API reference for the full options of enums.

curl --request POST \
  --url https://api.creatify.ai/api/link_to_videos/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: you-api-key' \
  --data '{
  "link": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "visual_style": "DynamicProductTemplate",
  "script_style": "DontWorryWriter",
  "aspect_ratio": "9x16",
  "video_length": 15,
  "language": "en",
  "target_audience": "marketing experts who believe in AI",
  "target_platform": "Tiktok"
}'

Example response

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "target_platform": "<string>",
  "target_audience": "<string>",
  "language": "<string>",
  "video_length": 15,
  "aspect_ratio": "<string>",
  "script_style": "DontWorryWriter",
  "visual_style": "DynamicProductTemplate",
  "link": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "media_job": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "<string>",
  "failed_reason": "<string>"
}

It starts with pending status, you will need the id (3c90c3cc-0d44-4b50-8888-8dd25736052a in this example) to check the status of the video.

​
Check the status of the video

curl --request GET \
  --url https://api.creatify.ai/api/link_to_videos/3c90c3cc-0d44-4b50-8888-8dd25736052a/ \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: you-api-key'

You will find the status to be done when finished. Meanwhile you can find the video output in video_output field.

Get your API keyAI Avatar API