> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoox.video/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing & Credits

> Understand API pricing, credit consumption, and cost optimization

## 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

<Card title="Pay-per-Use Model" icon="credit-card">
  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
</Card>

## Video Generation Costs

Video generation costs depend on several factors:

### Base Costs

<CardGroup cols={2}>
  <Card title="Standard Video" icon="play">
    **5 credits** every 30 seconds

    * Text-to-speech generation
    * Basic video assembly
    * Standard quality output
    * 15 seconds buffer included
  </Card>

  <Card title="With Animation" icon="sparkles">
    **+5 credits per image**

    * AI-powered movement
    * Cinematic effects
    * Professional quality
  </Card>
</CardGroup>

### Detailed Cost Breakdown

| Feature                     | Cost             | Notes                               |
| --------------------------- | ---------------- | ----------------------------------- |
| **Base Generation**         | 5 credits        | Every 30 seconds (with 15s buffer)  |
| **Image Animation**         | +5 credits/image | Transform static images into videos |
| **Avatar Generation (2K)**  | 2 credits        | Create or edit an avatar in 2K      |
| **Avatar Generation (4K)**  | 4 credits        | Create or edit an avatar in 4K      |
| **Custom Media Processing** | Included         | URL-based media integration         |

### Cost Examples

<Tabs>
  <Tab title="Basic Video">
    **Simple 60-second video**

    ```
    Base cost (60s): 10 credits
    (5 credits per 30s x 2 tranches)
    Total: 10 credits
    ```
  </Tab>

  <Tab title="Premium Content">
    **60-second video with avatar + 3 animated images**

    ```
    Base cost (60s): 10 credits
    Image animation (3 × 5): +15 credits
    Total: 25 credits
    ```
  </Tab>
</Tabs>

## Script Generation Costs

Script generation has a separate, predictable cost structure:

| Feature             | Cost                       | Notes                                 |
| ------------------- | -------------------------- | ------------------------------------- |
| **Base Generation** | 0.1 credits per 60 seconds | AI-generated script                   |
| **Web Search**      | +0.1 credits               | Enhanced with real-time information   |
| **URL Processing**  | +0.1 credits per URL       | Content extraction from provided URLs |

### Script Cost Examples

```python theme={null}
# 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

<CardGroup cols={2}>
  <Card title="API Videos" icon="code">
    **Included Free**

    First export is included in generation cost
  </Card>

  <Card title="Dashboard Videos" icon="browser">
    **5 credits per 30s**

    Standard export cost for dashboard-created videos
  </Card>
</CardGroup>

### High Resolution Surcharge

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

<Card title="4K & Higher" icon="expand">
  **+2.5 credits per 30s**

  * Applies to custom formats above 1080p
  * Added to base export cost
  * Charged for all video types (API and dashboard)
</Card>

### Avatar Quality Models

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

<CardGroup cols={2}>
  <Card title="Standard" icon="zap">
    **Free**

    Basic avatar quality that works well for most use cases. No additional credits required.

    **Best for:**

    * Quick exports
    * Budget-conscious projects
    * Testing and prototyping
  </Card>

  <Card title="Premium" icon="gem">
    **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*
  </Card>

  <Card title="Ultra" icon="crown">
    **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*
  </Card>

  <Card title="Veo 3 Fast" icon="google">
    **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*
  </Card>

  <Card title="Veo 3" icon="google">
    **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*
  </Card>

  <Card title="Veo 3 Lite" icon="google">
    **0.5 credits/sec** (720p) · **0.8 credits/sec** (1080p)

    Affordable Google Veo 3 model with good quality at lower cost. 720p for 4s/6s segments, 1080p for 8s segments.

    **Best for:**

    * Cost-effective content
    * High-volume production
    * Good quality at lower price

    *Available from Start plan*
  </Card>

  <Card title="Seedance 2" icon="sparkles">
    **4 credits/sec** (per segment)

    ByteDance Seedance 2 model for high-quality avatar generation with excellent realism.
    Billed per avatar segment (each segment = 8 seconds).

    **Best for:**

    * High-quality content
    * Realistic avatar rendering
    * Premium productions

    *Available from Pro plan*
  </Card>

  <Card title="Seedance 2 Fast" icon="bolt">
    **3 credits/sec** (per segment)

    ByteDance Seedance 2 Fast model for quick avatar generation with great quality.
    Billed per avatar segment (each segment = 8 seconds).

    **Best for:**

    * Fast turnaround
    * Good quality at speed
    * High-volume production

    *Available from Pro plan*
  </Card>
</CardGroup>

<Note>
  **Model availability:** Not all avatars support all models. Check the `model_available` field when fetching avatars to see which models are supported.
</Note>

<Info>
  Total export cost = Base cost + High resolution cost + Avatar cost
</Info>

### Export Cost Examples

<Tabs>
  <Tab title="Basic API Video">
    **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
    ```
  </Tab>

  <Tab title="4K Export">
    **60-second API video at 3840x2160**

    ```
    Base export: 0 credits (included)
    High-res cost: 5 credits (2 × 2.5)
    Avatar cost: 0 credits (no avatar)
    Total: 5 credits
    ```
  </Tab>

  <Tab title="Premium with Avatar">
    **90-second dashboard video, 4K, 60s Premium avatar**

    ```
    Base export: 15 credits (3 × 5)
    High-res cost: 7.5 credits (3 × 2.5)
    Avatar cost: 48 credits (60s × 0.8)
    Total: 70.5 credits
    ```
  </Tab>

  <Tab title="API Video with Veo">
    **60-second API video with 3 Veo 3 Fast segments**

    ```
    Base export: 0 credits (included)
    High-res cost: 0 credits (≤1080p)
    Avatar cost: 55.2 credits (3 × 8s × 2.3)
    Total: 55.2 credits
    ```
  </Tab>
</Tabs>

### Recommended First Steps

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

<CardGroup cols={2}>
  <Card title="Get API Key" href="/authentication" icon="key">
    Start with free credits and test the platform
  </Card>

  <Card title="Quick Start Guide" href="/quickstart" icon="rocket">
    Create your first video and understand costs
  </Card>
</CardGroup>