movoa

Unlimited AI video generator with sound: on paid plans the tenth take of a shot costs what the first did, and your first clip is free to make right now. This is the official Python SDK for Movoa: one API key turns a prompt into text to video, or a still into photo to video, and every clip comes back as AI video with audio.

pip install movoa

from movoa import generate_video

clip = generate_video("a paper boat drifting down a rain gutter, low angle, slow push-in")
print(clip)  # URL of the finished MP4, sound included

Standard library only, no dependencies. generate_video submits the run, waits for it and returns the URL of the finished file.

API key

Sign in on movoa.ai, create a key at movoa.ai/settings/apikeys, then pass it as api_key= or export it:

export MOVOA_API_KEY=sk-...

Runs cost credits on your Movoa account, at the prices on movoa.ai/pricing.

from movoa import credits
print(credits())  # remaining credits on the account

Text to video and photo to video

from movoa import generate_video

# text to video, vertical, 10 seconds
generate_video("a fox trotting through fresh snow at dawn, tracking shot",
               duration=10, aspect_ratio="9:16")

# photo to video: the photo becomes the first frame
generate_video("the camera slowly orbits the statue", image_url="https://example.com/statue.jpg")

# another model
generate_video("a street drummer in the rain, close-up", model="seedance-2-5", duration=10, resolution="720p")

Any extra keyword argument is sent in options as it is. Every run asks for sound. On the site: Seedance 2.5 and Veo 3.

Submit now, collect later

from movoa import submit, status, wait

task_id = submit("a lighthouse in a storm, waves crashing", "minimax-h3", duration=6)
print(status(task_id)["status"])  # pending | processing | success | failed | canceled
url = wait(task_id)               # polls every 10 seconds, 30 minutes by default

While a run waits in line, status() returns queued: True and queueEta in seconds.

Errors worth catching

Each failure is its own subclass of MovoaError, so you can branch on what to do next:

• AuthError: no key, or the key is wrong or deleted; create one at movoa.ai/settings/apikeys
• QuotaError: the account does not have enough credits for this run
• PlanError: that model or quality needs a plan on the account
• BusyError: too many runs on this account are generating at once
• RejectedError: the content filter refused the prompt, or a cooldown is active; reword it
• GenerationError: the run was accepted but failed or was canceled; .error_message says why
• TimeoutError: the wait ran out; .task_id lets you check the run later with status()

Any other refusal raises MovoaError with the server's message.

MIT licensed. Made by Movoa.