Skip to main content

​
Overview

Hoox API uses a credit-based pricing system where you pay for what you use. Credits are consumed when generating videos, creating scripts, and performing other operations. This guide explains how credits work and how to optimize your costs.

​
Credit System

​
How Credits Work

Pay-per-Use Model

Credits are consumed only when operations are performed:
  • Video Generation: Based on duration and features
  • Script Generation: Fixed cost per generation
  • Export: Included for API videos, charged for dashboard videos

​
Video Generation Costs

Video generation costs depend on several factors:

​
Base Costs

Standard Video

5 credits every 30 seconds
  • Text-to-speech generation
  • Basic video assembly
  • Standard quality output
  • 15 seconds buffer included

With Animation

+4-7 credits per image
  • Standard: +4 credits/image
  • Pro: +7 credits/image
  • AI-powered movement
  • Cinematic effects

​
Detailed Cost Breakdown

FeatureCostNotes
Base Generation5 creditsEvery 30 seconds (with 15s buffer)
Image Animation (Standard)+4 credits/imageBasic quality
Image Animation (Pro)+7 credits/imageAdvanced quality
Custom Media ProcessingIncludedURL-based media integration

​
Cost Examples

  • Basic Video
  • Premium Content
Simple 60-second video
Base cost (60s): 10 credits
(5 credits per 30s x 2 tranches)
Total: 10 credits

​
Script Generation Costs

Script generation has a separate, predictable cost structure:
FeatureCostNotes
Base Generation0.1 credits per 60 secondsAI-generated script
Web Search+0.1 creditsEnhanced with real-time information
URL Processing+0.1 credits per URLContent extraction from provided URLs

​
Script Cost Examples

# Basic script generation
{
    "prompt": "Create a video about renewable energy",
    "duration": 60
}
# Cost: 0.1 credits (1 x 60s tranche)

# Enhanced script with web search
{
    "prompt": "Create a video about renewable energy",
    "duration": 60,
    "webSearch": True,
    "urls": ["https://energy.gov/renewable"]
}
# Cost: 0.3 credits (0.1 base + 0.1 web search + 0.1 per URL)

​
Export Costs

API-generated videos include first export is free, included in the generation price.
  1. Test with simple content: Start with basic videos to understand quality
  2. Experiment with features: Try avatars and animations with small tests
  3. Monitor usage: Track credit consumption patterns
  4. Scale gradually: Increase feature usage based on results

​
Next Steps

Get API Key

Start with free credits and test the platform

Quick Start Guide

Create your first video and understand costs
⌘I