Adding Professional Narration to Your Animations Without Recording Equipment

# Install the package first
pip install animo

from animo import Animo
import os

# Initialize client with your API key
api_key = os.getenv("ANIMO_API_KEY")  # Or use your key directly
client = Animo(api_key=api_key)

# Generate a video with voice-over narration
prompt = "A rocket launching into space with voice-over explaining the launch sequence"
print(f"🚀 Generating video for: '{prompt}'")

# Start generation
generation = client.videos.generate(prompt=prompt)
request_id = generation.get("requestId")

print(f"✅ Generation started with ID: {request_id}")

# Check status (in a real app, you would poll until completion)
status_data = client.videos.retrieve(request_id=request_id)
status = status_data.get("status")

# When completed, get the video URL
if status == "SUCCEEDED":
    video_url = status_data.get("videoUrl")
    print(f"🎬 Video ready! URL: {video_url}")

from animo import Animo
import os
import time
import sys

# Get API key from environment variable
api_key = os.getenv("ANIMO_API_KEY")
if not api_key:
    print("Error: ANIMO_API_KEY environment variable not set")
    sys.exit(1)

# Initialize client
client = Animo(api_key=api_key)

# Create a prompt that specifies voice-over narration
prompt = "Create an animation of Earth rotating with day and night cycle, and use voice-over to explain the process"

print(f"🚀 Generating video for: '{prompt}'")

# Start generation
try:
    generation = client.videos.generate(prompt=prompt)
    request_id = generation.get("requestId")
    
    if not request_id:
        print("❌ No request ID received")
        sys.exit(1)
        
    print(f"✅ Generation started with ID: {request_id}")
    
    # Poll for status with a simple progress indicator
    print("⏳ Waiting for completion", end="")
    dots = 0
    
    while True:
        status_data = client.videos.retrieve(request_id=request_id)
        status = status_data.get("status")
        
        # Update progress indicator
        sys.stdout.write(".")
        sys.stdout.flush()
        dots = (dots + 1) % 3
        
        # Check for completion or error
        if status == "SUCCEEDED":
            video_url = status_data.get("videoUrl")
            print(f"\n\n🎬 Video ready! URL: {video_url}")
            
            # Print processing time if available
            if processing_time := status_data.get("processingTime"):
                print(f"⏱️  Processing time: {processing_time} seconds")
                
            break
            
        elif status == "FAILED":
            error = status_data.get("error") or "Unknown error"
            print(f"\n\n❌ Generation failed: {error}")
            break
            
        # Wait before next check
        time.sleep(3)
        
except KeyboardInterrupt:
    print("\n\n🛑 Process interrupted by user")
    sys.exit(0)
    
except Exception as e:
    print(f"\n\n❌ Error: {str(e)}")
    sys.exit(1)

"Create an animation that explains the three states of matter. 
First, show water molecules moving freely as a gas with the voiceover saying 'In the gas state, molecules move freely with high energy.'
Next, show the molecules slowing down and coming closer together as a liquid with the voiceover saying 'As temperature decreases, molecules slow down and form a liquid state.'
Finally, show the molecules arranged in a fixed pattern as a solid with the voiceover saying 'At even lower temperatures, molecules arrange in a fixed pattern, forming a solid.'"

"""
Create an animation explaining pros and cons of renewable energy sources. Use two different narrators: 
a male voice presenting the advantages and a female voice presenting the challenges. 
At the end, have both voices come together to summarize the balanced view.
"""

"""
Create an educational animation explaining how the human immune system works, with professional voice-over narration.
Use a female narrator with a warm, authoritative tone speaking at a moderate pace. The narration should:

1. Begin with an engaging question: 'Have you ever wondered how your body fights off millions of potential invaders every day?'
2. Clearly explain each component of the immune system as it appears on screen
3. Use analogies to make complex concepts relatable (e.g., 'White blood cells act like the body's security guards')
4. Include brief pauses after introducing complex concepts to allow viewers to process the information
5. End with a summary of the key points

The animation should progress from an overview of the immune system to specific mechanisms, showing both innate and adaptive immunity with clear, simple visuals.
"""