Video Generation

Learn how to generate videos with the Hoox API

How Video Generation Works

The Hoox API uses advanced AI to generate videos from various inputs:

1. Content Creation: From prompts, scripts, or existing media
2. Voice Synthesis: Convert text to natural-sounding speech
3. Visual Assembly: Combine media, animations, and transitions
4. Final Rendering: Export in your desired format

Generation Methods

Prompt-based

Generate videos from simple text prompts. The AI creates the script, finds media, and assembles everything.

Script-based

Provide your own script and let the AI handle voice synthesis and media selection.

Media-based

Use your own voice recordings or avatar videos as the foundation.

Hybrid

Combine multiple approaches for maximum control and customization.

Input Options

Text Content

Generate videos using text-based inputs. These options are perfect when you want the AI to handle voice synthesis and media selection automatically.

Prompt

Provide a simple text prompt and let the AI create everything from scratch - script, media selection, and voice synthesis. Perfect for quick content creation.

{
  "prompt": "Create an educational video about renewable energy sources, focusing on solar and wind power",
  "voice_id": "en-US-JennyNeural"
}

Script

Provide your own detailed script and let the AI handle voice synthesis and media selection. Ideal when you want control over the narrative but need help with production.

{
  "script": "Solar energy is one of the most promising renewable energy sources. It harnesses the power of the sun through photovoltaic cells...",
  "voice_id": "en-US-AriaNeural",
}

Media Content

Use your own media assets as the foundation for video generation. These options give you more control over the visual and audio elements of your videos.

Voice Recording

Use your own voice recordings as the audio track.

{
  "voice_url": "https://your-domain.com/voiceover.mp3"
}

Avatar Video

Start with an existing avatar video where someone is speaking.

{
  "avatar_url": "https://your-domain.com/avatar-speaking.mp4"
}

Custom Media

The AI will automatically analyze and place your media throughout the video based on the content.

{
  "prompt": "A vide oabout my product",
  "voice_id": "en-US-DavisNeural",
  "media_urls": [
    "https://your-domain.com/product-shot.jpg",
    "https://your-domain.com/demo-video.mp4"
  ]
}

Advanced Features

Custom Video Formats

Create videos with custom dimensions tailored to your specific needs. Beyond the standard formats (vertical, square, ads, horizontal), you can specify exact width and height dimensions.

{
  "prompt": "Create a product showcase video",
  "voice_id": "en-US-DavisNeural",
  "format": "custom",
  "width": 1200,
  "height": 1600
}

Custom dimensions support up to 5000px for both width and height, allowing you to create videos for any platform or display requirement.

Web Search Integration

Enhance your videos with real-time web content. The AI can search the internet during script writing to include current information, or find relevant images like celebrity photos, landmarks, content to enrich your video.

{
  "prompt": "Explain cryptocurrency basics",
  "voice_id": "en-US-JennyNeural",
  "webSearch": {
    "script": true,    // Enhance script with web research
    "images": true     // Find relevant images automatically
  }
}

Image Animation

Transform static images into dynamic videos using AI animation. Images from URLs are automatically converted into animated sequences, bringing still photos to life with natural movement and transitions.

{
  "script": "The landscape shows beautiful mountains...",
  "voice_id": "en-US-AriaNeural",
  "animate_image": true,
  "animate_image_max": 3        // Limit for cost control
}

Use the animate_image_max parameter to control animation costs when using many images.

Workspace Media Control

Control how workspace media is used:

{
  "prompt": "Create a company overview video",
  "voice_id": "en-US-DavisNeural",
  "use_space_media": false,      // Don't use workspace media
  "save_media_to_space": false   // Don't save generated media
}

Next Steps

Video Export

Learn how to export your generated videos

Generation API Reference

Detailed API documentation for video generation