Skip to main content

pydantic-ai-videogen

Official Pydantic AI tools for the VideoGen API. Give any Pydantic AI agent the ability to turn a script into a finished narrated video, plus generate standalone images, video clips, voiceovers, sound effects, music, and talking-head avatars.

Every tool wraps the official videogen SDK and runs as the team that owns your API key.

Install

pip install pydantic-ai-videogen

Setup

Get an API key from app.videogen.io/api and set it as VIDEOGEN_API_KEY:

export VIDEOGEN_API_KEY="your_api_key"

Usage

from pydantic_ai import Agent
from pydantic_ai_videogen import create_videogen_tools

agent = Agent(
    "openai:gpt-4o",
    tools=create_videogen_tools(),
    system_prompt="You produce short narrated videos with VideoGen when asked.",
)

result = agent.run_sync(
    "Make a short narrated video explaining why staying hydrated matters."
)
print(result.output)

By default each tool blocks until the workflow or tool execution finishes and returns the completed result.

Options

from videogen import VideoGen
from pydantic_ai_videogen import create_videogen_tools

tools = create_videogen_tools(
    # Provide a pre-configured client, or pass api_key / base_url, or rely on env.
    client=VideoGen(api_key="your_api_key"),

    # Return the run/execution id immediately instead of waiting.
    wait=False,

    # Only expose a subset of tools to the model.
    include=["script_to_video", "generate_image", "text_to_speech"],
)
Option Default Description
client — A pre-configured VideoGen client.
api_key VIDEOGEN_API_KEY API key used to build a client when client is omitted.
base_url VIDEOGEN_BASE_URL or production Override the API base URL.
wait True Block until the operation finishes and return the result.
poll_interval_ms SDK default Poll interval while waiting.
timeout_ms SDK default Maximum time to wait before giving up.
include all tools Restrict the returned tool set to these tool names.

Tools

  • Workflows: cancel_workflow_run, get_workflow_run, list_workflow_runs, prompt_to_video_clip, script_to_video, slideshow_to_video, storyboard_to_video, video_to_video, voiceover_to_video.
  • Media generation: cancel_tool_execution, generate_avatar, generate_image, generate_motion_graphic, generate_music, generate_sound_effect, generate_video_clip, get_tool_execution, image_3d_effect, list_tool_executions, remove_image_background, remove_video_background, text_to_speech, upscale_image, upscale_video, vectorize_image.
  • Projects: export_project, get_project, list_project_remix_actions, list_projects, remix_project.
  • Files: get_file, list_files, upload_file.
  • Resources and account: get_me, list_languages, list_tts_voices.

Avatar generation and supported video workflows use reusable actor entities. Pass actor_entity_id and set avatar_quality to LOW, STANDARD, HIGH, or MAX. Narrator changes are passed in remix_actions as CHANGE_NARRATOR action dictionaries.

Documentation

License

MIT

Account and permissions

Generation and editing use your VideoGen account credits. Obtain user approval before invoking credit-consuming tools. Restrict the include list when an agent only needs read access. Keep API keys in server-side environment variables and out of shared transcripts.

VideoGen · MCP setup · Source

2.5.4

Fix polling after workflow, media-tool and export starts to use the Python SDK’s normalized response keys. No API capabilities or dependency requirements changed.

Metadata

Release files for pydantic-ai-videogen 2.5.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pydantic-ai-videogen 2.5.4
File Size Uploaded Provenance Actions
pydantic_ai_videogen-2.5.4.tar.gz 12.8 kB Without provenance Details for pydantic_ai_videogen-2.5.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pydantic-ai-videogen 2.5.4
File Interpreter ABI Platform Actions
pydantic_ai_videogen-2.5.4-py3-none-any.whl Python 3 none any Details for pydantic_ai_videogen-2.5.4-py3-none-any.whl

Total release size: 26.2 kB

Release files / pydantic_ai_videogen-2.5.4.tar.gz

Download URL pydantic_ai_videogen-2.5.4.tar.gz
Size 12.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f7dc46d9cd0d5179f5004eba2795b959249cab78e29f4cdb0e6c6ade556e2ee3
BLAKE2b-256 checksum
How to use checksums
496a9e6bd055c726856c2cd532e7a6e2ee966fc5d3590c46c469a94d1d389a63
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.4

Release files / pydantic_ai_videogen-2.5.4-py3-none-any.whl

Download URL pydantic_ai_videogen-2.5.4-py3-none-any.whl
Size 13.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f8a934eb68ec20522d1673777a1195a4d2bf7324bfb8e89e93d0b44855142953
BLAKE2b-256 checksum
How to use checksums
6d67aa3269849c5ee3ccefc19c0a016addf57ba85da636d3600e0dcf3d39ff4b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.4

Security for pydantic-ai-videogen 2.5.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.5.4 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page