Creatify API Docs

Appearance

Billing and Credits ​

Fresh

Purpose ​

Understand the Creatify API credit system, costs per endpoint, and how to monitor your credit balance.

Prerequisites ​

Credit System Overview ​

Creatify uses a credit-based billing model. Each API operation consumes a specific number of credits, typically calculated per 30 seconds of output video.

Credit Cost Matrix ​

Video Generation Endpoints ​

EndpointCreatePreviewRenderNotes
URL to Video5/30s1/30s4/30sPreview + Render = cheaper than Create
AI Avatar v1 (Lipsync)5/30s----Single operation
AI Avatar v2 (Lipsync v2)5/30s--4/30sCreate + Render
AI Editing5/30s1/30s4/30sPreview + Render pattern
AI Shorts5/30s----Single operation
Custom Templates5/30s1/30s4/30sPreview + Render pattern
Product Video3----Image generation and regenerations are separate

Content and Asset Endpoints ​

EndpointCostUnit
AI Scripts1Per script
Text to Speech1Per 30 seconds
Asset GeneratorVariesPer generation
IAB Images2Per generation

Free Operations (0 Credits) ​

OperationDescription
Check remaining creditsGET /api/workspace/remaining_credits/
List itemsGET /api/{endpoint}/
Get item by IDGET /api/{endpoint}/{id}/
List voicesGET /api/voices/
List musicGET /api/musics/

Checking Your Balance ​

Step 1: Query Remaining Credits ​

bash
curl --request GET \
  --url https://api.creatify.ai/api/workspace/remaining_credits/ \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY"

Response:

json
{
  "remaining_credits": 150
}

Step 2: Calculate Cost Before Generating ​

Use this formula to estimate cost:

Cost = (video_duration_seconds / 30) * credits_per_30s

Example: A 60-second URL-to-video using preview + render:

Preview:  (60 / 30) * 1 = 2 credits
Render:   (60 / 30) * 4 = 8 credits
Total:    10 credits

Compare to creating directly without preview:

Create:   (60 / 30) * 5 = 10 credits
Total:    10 credits (same cost, but no preview to review)

Cost Optimization

The preview + render flow costs the same total credits as a direct create, but gives you the ability to review before committing to the render. Always use preview + render when available.

Monitoring Credit Usage ​

Build a Credit Monitor (Python) ​

python
import os
import requests

def check_credits():
    response = requests.get(
        "https://api.creatify.ai/api/workspace/remaining_credits/",
        headers={
            "X-API-ID": os.environ["CREATIFY_API_ID"],
            "X-API-KEY": os.environ["CREATIFY_API_KEY"]
        }
    )
    return response.json()["remaining_credits"]

def estimate_cost(duration_seconds, credits_per_30s):
    return (duration_seconds / 30) * credits_per_30s

# Before generating
credits = check_credits()
cost = estimate_cost(60, 5)  # 60s video at 5 credits/30s

if credits >= cost:
    print(f"Proceeding: {credits} credits available, {cost} needed")
else:
    print(f"Insufficient credits: {credits} available, {cost} needed")

Verification Checklist ​

  • [ ] Can query remaining credits successfully
  • [ ] Understand cost per endpoint for planned operations
  • [ ] Pre-calculated credit needs for batch operations
  • [ ] Credit monitoring integrated into production workflow

See Also