Skip to main content

​
Capabilities

CategoryWhat You Can Create
ImagesText-to-image with aspect ratio control
AudioMusic, sound effects, text-to-speech
VideoShort AI-generated clips (5-8 seconds)
LocalizationDubbing, transcript translation

​
Quick Example

import videodb

conn = videodb.connect()
coll = conn.get_collection()

# Generate an image
image = coll.generate_image(
    prompt="Futuristic city skyline at sunset",
    aspect_ratio="16:9"
)
print(image.generate_url())

# Generate a voiceover
voice = coll.generate_voice(
    text="Welcome to our product demo",
    voice_name="Sarah"
)

# Dub a video to Spanish
dubbed = coll.dub_video(
    video_id="m-xxx",
    language_code="es"
)

​
Cheat Sheet

# Image
coll.generate_image(prompt, aspect_ratio='1:1', callback_url=None)

# Music
coll.generate_music(prompt, duration=5, callback_url=None)

# Sound Effect
coll.generate_sound_effect(prompt, duration=2, callback_url=None)

# Voice
coll.generate_voice(text, voice_name='Default', config={}, callback_url=None)

# Video
coll.generate_video(prompt, duration=5, callback_url=None)

# Dub
coll.dub_video(video_id, language_code, callback_url=None)

# Translate
video.translate_transcript(language, additional_notes='', callback_url=None)

​
Async Processing

All generative calls support asynchronous processing:
  1. When callback_url is not provided: SDK returns an asset object once the process is done (synchronous processing)
  2. When callback_url is provided: SDK returns immediately and sends a webhook when complete (asynchronous processing)
  3. Call .generate_url() to get the finished file URL

​
Callback Payload

{
  "success": true,
  "data": {
    "id": "img-z-019c4cb6-207c-7d23-aab1-e8ef7a5fcde1",
    "collection_id": "c-3b0a66f2-fac5-4816-b29e-e606986c0490",
    "name": "Futuristic City Sunset Skyline",
    "extension": "png",
    "size": "1607220"
  }
}

​
Guide Index

Images, Audio & Video

Generate images, music, SFX, voices, and video

Translation & Dubbing

Localize content into 20+ languages

​
What You Can Build

AI Voiceovers

Add narration to silent footage with AI-generated voices

Video Dubbing

Localize videos into multiple languages

Voice Cloning

Replace voices with cloned audio preserving tone and style

Trailer Narration

Create dramatic trailers with compelling voiceovers