lavendly 0.0.1

Official Python SDK for Lavendly - generate AI video with one API call.

lavendly

Official Python SDK for Lavendly.

pip install lavendly

from lavendly import Lavendly

vs = Lavendly(api_key="lv_...")

wf = vs.workflows.create(
    name="Fox in a bookshop",
    shots=[{"prompt": "a sleepy fox in a bookshop", "duration": 5}],
)

video = vs.renders.run(wf["id"])
print(video.url)

Highlights

• Sync + async. Same surface; Lavendly and AsyncLavendly.
• Idempotent by default. Every mutating method accepts idempotency_key.
• One-call renders. vs.renders.run() creates + polls to completion.
• Tool-use dispatcher. vs.call(operation, args) for the Anthropic SDK tool_use pattern.
• Bundled skills. from lavendly.skills import load_skill returns the markdown body of storyteller, multi-clip, cost-aware.

Async

import asyncio
from lavendly import AsyncLavendly

async def main():
    async with AsyncLavendly(api_key="...") as lavendly:
        wf = await vs.workflows.create(name="x", shots=[...])
        return await vs.renders.run(wf["id"])

result = asyncio.run(main())

Errors

from lavendly import LavendlyError
try:
    vs.workflows.create(name="...", shots=[...])
except LavendlyError as e:
    print(e.code, e.status, e.details)

Full docs

https://docs.lavendly.ai/sdks/python

License

MIT