Video Output

Generate videos with AI tools in Agno agents.

Generate a video with Fal in an Agno agent.

Prerequisites

You'll need to have the following:

  • fal_client library installed
  • An API key from Fal

Setup

uv pip install -U agno openai fal-client
export FAL_KEY=***
export OPENAI_API_KEY="your_openai_api_key_here"

FalTools checks the FAL_API_KEY environment variable and logs an error when it is missing. Authentication still works with FAL_KEY alone because fal_client reads it directly. Set both variables to avoid the log message.

Code

video_agent.py
from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.fal import FalTools

fal_agent = Agent(
    name="Fal Video Generator Agent",
    model=OpenAIResponses(id="gpt-5.2"),
    tools=[
        FalTools(
            model="fal-ai/hunyuan-video",
            enable_generate_media=True,
        )
    ],
    description="You are an AI agent that can generate videos using the Fal API.",
    instructions=[
        "When the user asks you to create a video, use the `generate_media` tool to create the video.",
        "Return the URL as raw to the user.",
        "Don't convert video URL to markdown or anything else.",
    ],
    markdown=True,
)

fal_agent.print_response("Generate video of balloon in the ocean")