Skip to main content

​
What is the Creatify API?

The Creatify API is a comprehensive video generation platform that allows you to create professional marketing videos through various endpoints. Our API offers URL-to-video conversion, AI avatar lip synchronization, Aurora image-to-video transformation, Custom template, Product to video, AI Shorts, AI Editing, and Text to Speech functionality.

​
What sets Creatify API apart from other video generation APIs?

Creatify API unifies URL‑to‑video, lip sync avatars, Aurora image‑to‑video, product‑to‑video, AI Shorts, AI Editing, custom templates, and text‑to‑speech in one platform. Our API is designed to generate ready-to-use marketing videos that do not require any further post production.

​
What are the prerequisites for using the Creatify AI API?

To use the Creatify API, you need:
  • An active Creatify account
  • Valid API ID and API Key (found in your account settings)
  • Sufficient credits or an active subscription plan
  • Proper authentication headers (X-API-ID and X-API-KEY) in your API requests

​
Privacy & data use

Collects minimal operational + usage metadata; no selling of personal data; supports deletion & marketing opt‑out. Full policy: https://creatify.ai/privacy

​
Do all endpoints consume credits?

No. Only creation / generation endpoints deduct credits; simple GET/LIST endpoints do not. Credits for video generation scale with output length (longer outputs consume more) — see pricing details

​
What if I run out of credits?

Job creation or processing returns an insufficient credits error. Next steps:

​
Enterprise / high volume (>2000 videos)?

For scale (e.g. >2k renders / month, dedicated custom avatar capacity) schedule a call: https://calendly.com/creatify-ai/enterprise-demo-call

​
Are custom avatars billed separately?

Custom avatar creation is not charged using credits. If you need additional avatar capacity, you can purchase more through Settings → Subscription → Add-on Avatar Slot on the website. For large-scale custom avatar needs, contact our sales team for volume discounts.

​
How do I authenticate?

Send both headers on every request: 
X-API-ID: <your-id>
X-API-KEY: <your-key>
Skip either and you get 401; never expose these in public/front-end code.

​
How do I protect my keys?

Best practices:
  • Store in server env vars / secret manager (never ship to browsers/mobile).
  • Rotate immediately if logged or suspected leaked.
  • Monitor abnormal request bursts (potential abuse).
Structured snapshot of a fetched URL: extracted assets, text summaries, metadata. Flow:
  1. POST /api/links/ with the URL.
  2. (Optional) PUT /api/links// to refine assets / copy.
  3. POST /api/link_to_videos/ referencing link_id + style params.
  4. Poll status or use webhook → download output URL.
Yes, it’s recommended to update the link information before creating a video. You can provide a logo URL, remove low-quality image/video URLs, or update the description to highlight specific features. Use the PUT request to the /api/links// endpoint to update the link.

​
What is the latency of the Creatify Video APIs?

The latency varies by API endpoint:
  • Link creation: Typically takes less than 60 seconds
  • Link to video: Generating a video from a link takes around 5 minutes (includes script generation, audio creation, avatar matching, asset selection, and lip synchronization)
  • Lipsyncs API: Approximately 1:10 ratio, meaning a 15-second video takes about 150 seconds.

​
How do I generate a lipsync video?

Steps:
  1. POST /api/lipsyncs/.
  2. Poll GET /api/lipsyncs// until status=done or use webhook.
  3. Download video_output URL.

​
What’s the difference between Lipsync v1 and v2?

Lipsync v2 API allows you to structure your video as a sequence of scenes, where you can customize the avatar, voice, script, captions, call-to-action (CTA), and more for each scene. Use the /api/lipsyncs_v2/ endpoints for the latest features.

​
How many personas exist?

1000+ (expanding). Query the listing endpoint or check dashboard for live catalog. Evaluate a few voices/styles early to settle on brand tone.

​
What is Aurora?

Still image → speaking / blinking / subtle expression animation. Great for: product spokespeople, legacy photos, stylized mascots.

​
Do pets or stylized images work in Aurora?

Yes, if facial landmarks are discernible. Checklist: good lighting, frontal or near‑frontal angle, minimal motion blur.

​
What does AI Editing do?

The AI Editing API lets you upload a raw/source video and automatically apply cinematic editing styles. It’s ideal for transforming user‑generated, webinar, tutorial, or brand footage into share‑worthy, platform‑ready content with minimal manual effort.

​
Why use Custom Templates?

Design layout once, then feed dynamic data for scale (catalog feeds, localized offers, A/B variants).

​
Custom Template workflow

  1. Design in dashboard and.
  2. List templates → capture template_id.
  3. Submit job with payload.
  4. Poll status or use webhook → download output.

​
What are common job states?

Lifecycle: pending → queued → running → done | failed | rejected.

​
How to get the output video?

Use webhook or poll. Stop on done or failed; on success fetch and cache the video_output URL if you’ll reuse it.

​
Common status codes

Summary:
  • 200/201 success.
  • 400 validation issue (inspect error payload).
  • 401 auth problem.
  • 403 permission.
  • 404 not found.
  • 429 rate limited.
  • 500 internal (retry).

​
Systematic debug approach

Checklist:
  1. Minimal cURL reproduction.
  2. Verify headers & content-type.
  3. Validate JSON schema & required fields.
  4. Check credits/quota & permissions.
  5. Ensure correct resource ID & endpoint.
  6. Capture error body + request id for support.

​
Content restrictions

Obey IP & likeness laws; avoid prohibited or abusive content; adhere to downstream platform ad / community policies.

​
Ethical usage guidance

Disclose AI‑generated nature when required; do not impersonate without consent; prefer transparency for trust. Examples:
  • Bulk e‑commerce feed → short ads.
  • UGC‑style explainers for product onboarding.
  • Article / long video → localized shorts.
  • Persona driven multi‑language brand intros.
Public case studies: 3–10x production speed, ~90% time cuts, scaled multi‑platform output. Browse: https://creatify.ai/case-study

​
Support channels

Options: in‑app chat(in-app questions), api@creatify.ai (technical), enterprise booking link (enterprise plan). What to include in a support ticket Bundle context:
  • Endpoint + sanitized payload.
  • Full status + response body.
  • Timestamp + timezone.
  • Request / job ID.
  • Expected vs actual behavior.

​
Feature requests

Need an API feature not yet exposed (new endpoint, extra param, parity with website UI)? Email api@creatify.ai including:
  • Use case & expected monthly volume.
  • Desired capability (precise param / endpoint sketch).
  • Business impact (time saved, revenue, compliance, etc.).
Need something not covered? Open a support ticket with context—detailed inputs speed resolution.
⌘I