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

Metadata

Release files for pydantic-ai-videogen 2.5.3

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.3
File Size Uploaded Provenance Actions
pydantic_ai_videogen-2.5.3.tar.gz 12.0 kB Without provenance Details for pydantic_ai_videogen-2.5.3.tar.gz

Built distribution (wheel)

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

Total release size: 25.4 kB

Release files / pydantic_ai_videogen-2.5.3.tar.gz

Download URL pydantic_ai_videogen-2.5.3.tar.gz
Size 12.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4317bd9aa3aff6b316214e2f1bd303c35f88c2264a6ce640e875a20ae4c36948
BLAKE2b-256 checksum
How to use checksums
253a140007663d31824b315bf7344e4dd5bf90779c5a697773ab5601a262aaff
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.3-py3-none-any.whl

Download URL pydantic_ai_videogen-2.5.3-py3-none-any.whl
Size 13.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1033dde299081c49d68855c28c54af6e438bf2340b2f6a23fffdad7dc1411636
BLAKE2b-256 checksum
How to use checksums
6580ad64ff65c65c201586382d96cf8ad72a723280f526648780051f12d22bff
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.3

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.3 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