Creatify API Docs

Appearance

Frequently Asked Questions ​

Fresh

General ​

What is Creatify API? ​

Creatify API is a REST API for AI-powered video generation. It can create video ads, avatar videos, product videos, short-form content, and more from URLs, text, images, or audio.

What is the base URL? ​

https://api.creatify.ai

How does authentication work? ​

Every request requires two headers: X-API-ID and X-API-KEY. Get both from your Creatify dashboard under Settings then API. See the Authentication SOP.

Credits and Billing ​

How do credits work? ​

Credits are consumed per API operation. Video generation credits are calculated per 30 seconds of output video. For example, a 60-second video at 5 credits/30s costs 10 credits.

How do I check my credit balance? ​

Call GET /api/workspace/remaining_credits/ -- this endpoint is free (0 credits).

Is preview + render cheaper than direct create? ​

No -- the total cost is the same (preview 1/30s + render 4/30s = 5/30s total). The advantage is you can review the preview before committing to the render.

What happens if I run out of credits mid-task? ​

Tasks that are already processing will complete. New task creation will return a 402 error.

Video Generation ​

How long does video generation take? ​

Typical times: Text to Speech 10-30s, AI Scripts 5-30s, AI Avatar v1 30s-3min, URL to Video 1-5min, Aurora 2-10min.

Can I generate videos in different aspect ratios? ​

Yes. Most video endpoints support 9:16 (vertical/mobile), 16:9 (landscape), and 1:1 (square).

Can I use my own avatar? ​

Yes. You can either use BYOA (upload consent and training videos, takes 1-2 business days) or DYOA (describe appearance, AI generates it). See Custom Avatar BYOA SOP and DYOA SOP.

What is the difference between v1 and v2 avatars? ​

v1 (Lipsync): Single scene, single avatar, single voice. v2 (Lipsync v2): Multiple scenes with different avatars, voices, and backgrounds per scene. See the Avatar Pipeline Workflow.

What is Aurora? ​

Aurora is Creatify's state-of-the-art avatar model. It takes a single portrait image and generates studio-grade, hyper-realistic avatar video. See Aurora SOP.

Technical ​

Are API calls synchronous or asynchronous? ​

All video generation is asynchronous. You create a task (POST), receive a task ID, then poll (GET) until the status is done or failed.

How often should I poll for task completion? ​

Every 5-10 seconds for most endpoints. For Aurora, poll every 10-15 seconds. See Status Codes Reference.

What file formats are supported? ​

Video input: MP4. Audio input: MP3, WAV. Image input: JPG, PNG. Video output: MP4. Audio output: MP3.

Can I run multiple tasks in parallel? ​

Yes. There is no explicit limit on concurrent tasks, but respect rate limits. See Batch Production Workflow.

Links scrape a webpage URL and extract title, description, and media (images). The link ID is then used in URL-to-video generation.

What if the scraped data is wrong or incomplete? ​

Use POST /api/links/with_params/ to manually provide title, description, and media URLs.

Does the URL need to be publicly accessible? ​

Yes. Creatify's scraper cannot access URLs behind authentication, firewalls, or localhost.

See Also