Create URL to Video

FreshPOST

POST https://api.creatify.ai/api/link_to_videos/

Create a video from a URL. Creatify analyzes the page content, extracts product information and images, and generates a video ad automatically.

Credit Cost

5 credits per 30 seconds of video

Request Body

Name	Type	Required	Description
url	string	Yes	The URL to generate a video from
aspect_ratio	string	No	Video aspect ratio (e.g., 16:9, 9:16, 1:1)
voice_id	string	No	Voice ID for narration
creator_id	string	No	Avatar ID to use as presenter
language	string	No	Language code for the video
style	string	No	Video style preset

Headers

Header	Type	Required	Description
X-API-ID	string	Yes	Your Creatify API ID
X-API-KEY	string	Yes	Your Creatify API key
Content-Type	string	Yes	application/json

Example Request

curl -X POST 'https://api.creatify.ai/api/link_to_videos/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com/product-page",
    "aspect_ratio": "9:16",
    "voice_id": "voice-en-001"
  }'

Response

{
  "id": "ltv-001",
  "status": "pending",
  "url": "https://example.com/product-page",
  "aspect_ratio": "9:16",
  "created_at": "2024-01-15T10:30:00Z"
}

Status Codes

Code	Description
201	Task created successfully
400	Bad request -- invalid URL or parameters
401	Unauthorized -- invalid API credentials
402	Insufficient credits
429	Rate limit exceeded
500	Internal server error

Workflow

1. Create the task with POST /api/link_to_videos/
2. Poll GET /api/link_to_videos/{id}/ until status is done
3. Generate preview with POST /api/link_to_videos/preview/ (1 credit/30s)
4. Render final video with POST /api/link_to_videos/render/ (4 credits/30s)

TIP

For best results, provide URLs to product pages with clear images and descriptions. E-commerce pages work particularly well.