velvi 0.1.0

Python client for the Velvi Seedance 2 video generation API.

velvi-python

velvi is a thin Python SDK for the Velvi Seedance 2 partner API.

It wraps the partner-facing endpoints under /api/v1/video/seedance2 so external users do not need to manage raw curl requests for task creation, polling, and asset uploads.

Install

pip install velvi

Quickstart

from velvi import Velvi

client = Velvi(
    api_key="velvi_partner_key_here",
    base_url="https://api.velvi.tech",
)

task = client.create(
    model="seedance2-fast",
    prompt="A cinematic close-up of a silver sports car driving through rain at night.",
    duration=5,
    ratio="16:9",
)

result = client.wait(task.id, poll_interval=5.0)
print(result.status)
print(result.content.video_url if result.content else None)

Resource API

from velvi import Velvi, first_frame, reference_image

client = Velvi(api_key="velvi_partner_key_here")

asset = client.assets.upload("frame.png")

task = client.videos.create(
    model="seedance2",
    content=[
        {"type": "text", "text": "The subject smiles softly and turns toward camera."},
        first_frame(asset.asset_ref),
        reference_image("https://example.com/style-reference.png"),
    ],
    return_last_frame=True,
)

result = client.videos.wait(task.id)
print(result.content.video_url)
print(result.content.last_frame_url)

Environment Variables

• VELVI_API_KEY: default API key if api_key is omitted.
• VELVI_BASE_URL: default API hostname if base_url is omitted. The SDK appends /api/v1 automatically when needed.

Supported Operations

• client.create(...)
• client.get(task_id)
• client.list(...)
• client.wait(task_id, ...)
• client.cancel(task_id)
• client.assets.upload(...)
• client.assets.get(...)
• client.assets.list(...)
• client.assets.delete(...)

Packaging

Build locally with:

cd sdk/python
python -m build

Then publish with your normal PyPI release flow once the package name and credentials are set up.