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

Metadata

Release files for crewai-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 crewai-videogen 2.5.3
File Size Uploaded Provenance Actions
crewai_videogen-2.5.3.tar.gz 12.2 kB Without provenance Details for crewai_videogen-2.5.3.tar.gz

Built distribution (wheel)

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

Total release size: 25.5 kB

Release files / crewai_videogen-2.5.3.tar.gz

Download URL crewai_videogen-2.5.3.tar.gz
Size 12.2 kB
Tags Source
SHA-256 checksum
How to use checksums
5fa0b047a2c8be64ff8088ff3c410fdd3c4868360a7fa5c1cf4b7fbc2be6c3c5
BLAKE2b-256 checksum
How to use checksums
6feb91f0f97d3c5a622efdc13ba054a54c40406e794f0dcdf3c1c96fbb1d6147
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.3-py3-none-any.whl

Download URL crewai_videogen-2.5.3-py3-none-any.whl
Size 13.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2dfd51974048189aaa06ef4968fc8b8254fcccea7f59cb379e9641d75d960f91
BLAKE2b-256 checksum
How to use checksums
24a88bf05836a2b63aff5141f95b3b21832a900fe644fc124a06f0b3dc215790
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.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