Generate videos with a single prompt. Describe what you want in plain text, and the agent handles avatar selection, scripting, scene composition - all in one.
Install
pip install requestsRun the model
import requests
response = requests.post(
"https://api.runflow.io/v1/run/v3/video-agent",
headers={"Authorization": "Bearer RUNFLOW_API_KEY"},
json={
"prompt": "Create a 20-second professional product announcement video from a CTO introdu..."
},
)
data = response.json()
print(data["video"]["url"])Input schema
| Parameter | Type | Description |
|---|---|---|
| prompt | string | Natural language prompt describing the video to generate. The agent handles avatar selection, script, and production automatically. |
| orientation | string | Video orientation. Auto-detected from the prompt if omitted. |
| avatar | string | Avatar to use in the video. Set to 'auto' to let the agent auto-select based on the prompt. |
| file_urls | file_list | URLs of files to include as assets in the video (images, videos, audio, PDFs). Maximum 20 files. |
| incognito_mode | boolean | When enabled, disables the agent's memory functions. |
| style_id | string | Style template ID from the /v3/video-agent/styles endpoint. |
| voice | string | Voice for narration. Set to 'auto' to let the agent auto-select. |
Output schema
| Field | Type | Description |
|---|---|---|
| video | string | The generated video file. |
Related models
Veo 3.1 Lite
google/veo3.1/lite
Veo 3.1 Lite balances practical utility with professional capabilities....
Wan 2.7 Text to Video
alibaba/wan/v2.7/text-to-video
Wan 2.7 is the latest generation AI video model, delivering enhanced motion smoo...
Seedance 2.0 Fast Text to Video
bytedance/seedance/2.0/fast/text-to-video
Fast variant of Seedance 2.0 for quicker text-to-video generation with synchroni...
Seedance 2.0 Text to Video
bytedance/seedance/2.0/text-to-video
Seedance 2.0 generates high-quality videos from text prompts with synchronized a...
Start generating with HeyGen Video Agent V3
Get API access in minutes. No GPU setup, no infrastructure to manage.