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

+5 credits per image
  • AI-powered movement
  • Cinematic effects
  • Professional quality

​
Detailed Cost Breakdown

FeatureCostNotes
Base Generation5 creditsEvery 30 seconds (with 15s buffer)
Image Animation+5 credits/imageTransform static images into videos
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

Export costs vary based on how the video was created, resolution, and avatar model:

​
Base Export Cost

API Videos

Included FreeFirst export is included in generation cost

Dashboard Videos

5 credits per 30sStandard export cost for dashboard-created videos

​
High Resolution Surcharge

Videos exported at resolutions exceeding 1080p (width > 1920px OR height > 1080px) incur an additional cost:

4K & Higher

+2.5 credits per 30s
  • Applies to custom formats above 1080p
  • Added to base export cost
  • Charged for all video types (API and dashboard)

​
Avatar Quality Models

When your video includes an avatar, you can choose from five quality models with different performance and cost characteristics:

Standard

FreeBasic avatar quality that works well for most use cases. No additional credits required.Best for:
  • Quick exports
  • Budget-conscious projects
  • Testing and prototyping

Premium

0.8 credits/sec (avatar visibility)Highly realistic and dynamic avatar rendering with enhanced facial expressions and movements.Best for:
  • Professional content
  • Marketing videos
  • High-quality presentations
Available from Start plan

Ultra

2.3 credits/sec (avatar visibility)Enhanced realism with the highest quality output. Longer processing time for superior results.Best for:
  • Premium content
  • Flagship campaigns
  • Maximum quality requirements
Enterprise plan only

Veo 3 Fast

2.3 credits/sec (per segment)Google Veo 3 Fast model for quick, high-quality generation with AI-powered avatars. Billed per avatar segment (each segment = 8 seconds).Best for:
  • Fast turnaround
  • AI-generated avatars
  • Modern content creation
Available from Start plan

Veo 3

5 credits/sec (per segment)Google Veo 3 standard model for the highest quality AI-generated avatars. Exceptional realism. Billed per avatar segment (each segment = 8 seconds).Best for:
  • Cutting-edge quality
  • Premium AI content
  • Maximum realism
Available from Start plan
Model availability: Not all avatars support all models. Check the model_available field when fetching avatars to see which models are supported.
Total export cost = Base cost + High resolution cost + Avatar cost

​
Export Cost Examples

  • Basic API Video
  • 4K Export
  • Premium with Avatar
  • API Video with Veo
60-second API video, standard resolution
Base export: 0 credits (included)
High-res cost: 0 credits (≤1080p)
Avatar cost: 0 credits (no avatar)
Total: 0 credits
  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