Skip to main content

crewai-videogen

Official CrewAI tools for the VideoGen API. Give any CrewAI agent or crew 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 crewai-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 crewai import Agent, Crew, Task
from crewai_videogen import create_videogen_tools

tools = create_videogen_tools()

producer = Agent(
    role="Video Producer",
    goal="Produce short narrated videos on request",
    backstory="An expert at turning briefs into finished videos with VideoGen.",
    tools=tools,
)

task = Task(
    description="Make a short narrated video about why hydration matters.",
    expected_output="A link to the finished video.",
    agent=producer,
)

crew = Crew(agents=[producer], tasks=[task])
print(crew.kickoff())

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

Options

from videogen import VideoGen
from crewai_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 agent.
    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 crewai-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 crewai-videogen 2.5.4
File Size Uploaded Provenance Actions
crewai_videogen-2.5.4.tar.gz 12.9 kB Without provenance Details for crewai_videogen-2.5.4.tar.gz

Built distribution (wheel)

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

Total release size: 26.4 kB

Release files / crewai_videogen-2.5.4.tar.gz

Download URL crewai_videogen-2.5.4.tar.gz
Size 12.9 kB
Tags Source
SHA-256 checksum
How to use checksums
6cffa8ada32edfc3091386d6c0597031b744d20c3d7a168e9306fe84fcce1a55
BLAKE2b-256 checksum
How to use checksums
233ce3b60aca9acf9b04e754067814723e358aa1c28418b3e1aa289e31646307
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.4

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

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

Security for crewai-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