Billing and Credits

Fresh

Purpose

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

Prerequisites

• Authenticated API access (Authentication SOP)

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

Endpoint	Create	Preview	Render	Notes
URL to Video	5/30s	1/30s	4/30s	Preview + Render = cheaper than Create
AI Avatar v1 (Lipsync)	5/30s	--	--	Single operation
AI Avatar v2 (Lipsync v2)	5/30s	--	4/30s	Create + Render
AI Editing	5/30s	1/30s	4/30s	Preview + Render pattern
AI Shorts	5/30s	--	--	Single operation
Custom Templates	5/30s	1/30s	4/30s	Preview + Render pattern
Product Video	3/30s	--	--	Lower cost

Content and Asset Endpoints

Endpoint	Cost	Unit
AI Scripts	1	Per script
Text to Speech	Varies	Per generation
Asset Generator	Varies	Per generation
IAB Images	2	Per generation

Free Operations (0 Credits)

Operation	Description
Check remaining credits	GET /api/workspace/remaining_credits/
List items	GET /api/{endpoint}/
Get item by ID	GET /api/{endpoint}/{id}/
Create link	POST /api/links/
List voices	GET /api/voices/
List music	GET /api/musics/

Checking Your Balance

Step 1: Query Remaining Credits

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:

{
  "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)

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

• Credit Costs Quick Reference -- Full credit table
• Batch Production Workflow -- Managing credits at scale
• Quickstart -- First API call