Python SDK

pip install lavendly

from lavendly import Lavendly
import os

vs = Lavendly(api_key=os.environ["LAVENDLY_API_KEY"])

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

video = vs.renders.run(wf["id"])   # creates a render and polls to done
print(video.url)

wf = vs.workflows.create(
    name="Barista at dawn",
    shots=[{"prompt": "a barista pulling an espresso shot at dawn",
            "duration": 6}],
)

# Clip ids are generated; take the first clip of the workflow.
clip_id = next(n["id"] for n in wf["nodes"] if n["type"] == "videoGenerator")

vs.audio.attach_track(
    wf["id"], clip_id,
    kind="voiceover",
    script="Forty seconds. The whole café holds its breath.",
    subtitle_style="tiktok",
    idempotency_key=f"vo-{wf['id']}",
)

vs.audio.attach_track(
    wf["id"], clip_id,
    kind="music",
    mood="warm low jazz piano",
    ducking=True,
    volume=0.4,
    idempotency_key=f"music-{wf['id']}",
)

vs.audio.set_clip_native_audio(
    wf["id"], clip_id,
    mode="mix", volume=0.6,
)

video = vs.renders.run(wf["id"], idempotency_key=f"render-{wf['id']}")
print(video.url)

import asyncio
from lavendly import AsyncLavendly

async def render_one(brief):
    async with AsyncLavendly(api_key=os.environ["LAVENDLY_API_KEY"]) as lavendly:
        wf = await vs.workflows.create(name=brief["name"], shots=brief["shots"])
        return await vs.renders.run(wf["id"])

results = await asyncio.gather(*(render_one(b) for b in briefs))

job = vs.renders.create(wf["id"], idempotency_key=f"render-{wf['id']}")

while True:
    status = vs.renders.get(wf["id"], job["job_id"])
    print(f"{status['status']}, {int((status.get('progress') or 0) * 100)}%")
    if status["status"] == "done":
        return status["result"]["video_url"]
    if status["status"] == "failed":
        raise RuntimeError(status.get("error"))
    time.sleep(4)

ledger = vs.ledger.get()
if ledger["available"] < 20:
    raise RuntimeError(f"Budget too low: {ledger["available"]} credits")

usage = vs.usage.monthly()
if usage.fraction_used > 0.85:
    print("Monthly budget over 85%, pausing")
    return

from lavendly import LavendlyError

try:
    vs.workflows.create(name="huge", shots=big_list)
except LavendlyError as err:
    print(err.code)     # 'workflow_too_large'
    print(err.message)  # human-readable
    print(err.status)   # 413

from lavendly.skills import load_skill

skill_text = load_skill("storyteller")     # returns the markdown body
system_prompt = base_prompt + "\n\n" + skill_text