whiteframes 0.1.0

Python SDK for Whiteframes AI — create AI-powered videos programmatically

Whiteframes AI Python SDK

Create AI-powered videos programmatically with a single Python call.

Installation

pip install whiteframes

Quick Start

from whiteframes import WhiteframesAI

client = WhiteframesAI(api_key="wfai_your_key_here")

# Create a video (blocks until ready, ~2 minutes)
video = client.create_video(
    prompt="Explain how neural networks learn",
    voice="Stephen",
    quality="standard",
    scenes=8,
    video_type="educational",
)

print(video.title)          # "How Neural Networks Learn"
print(len(video.scenes))    # 8
print(video.scenes[0].narration)

Async (non-blocking)

job = client.create_video_async(prompt="Explain blockchain")
print(job.job_id)  # save this, poll later

# Poll manually
job.refresh()
print(job.status, job.progress)

# Or block with progress callback
def show_progress(progress, message):
    print(f"[{progress}%] {message}")

video = job.wait(on_progress=show_progress)

Supported Voices

voiceId	Language	Gender
Stephen	en-US	Male
Matthew	en-US	Male
Ruth	en-US	Female
Joanna	en-US	Female
Amy	en-GB	Female
Brian	en-GB	Male
Olivia	en-AU	Female

Supported Video Types

whiteboard, saas-demo, infographic, corporate, architecture, educational, social-short, pitch, onboarding, storytelling, news, videocast

Videocast (Multi-speaker)

video = client.create_video(
    prompt="Discuss the future of AI",
    video_type="videocast",
    scenes=8,
    speaker_voices={
        "speaker_1": "Stephen",
        "speaker_2": "Ruth",
        "speaker_3": "Brian",
    },
)

Error Handling

from whiteframes import WhiteframesAI, InsufficientCreditsError, ContentRejectedError

try:
    video = client.create_video(prompt="...")
except InsufficientCreditsError:
    print("Not enough credits")
except ContentRejectedError:
    print("Content was rejected by moderation")

Get API Key

Sign in at whiteframes.ai → Settings → API Keys → Create Key.