Video Agent API

Hi HeyGen team,

We use the Video Agent API to produce a professional AI-powered YouTube channel with strict brand and legal standards. Every video requires scene-by-scene review before rendering.

The current POST /v1/video_agent/generate endpoint is one-shot — it renders immediately with no way to inspect the plan before credits are consumed. The blueprint preview that exists in the web UI Chat
Mode is not accessible via API at all.

What we're requesting:

A simple two-step API flow:

POST /v1/video_agent/plan — generates the scene blueprint, returns scene breakdown, no credits charged, no rendering begins
POST /v1/video_agent/generate — accepts a plan_id, renders only after explicit approval

Or at minimum — a dry_run: true parameter on the existing generate endpoint that returns the plan without triggering render.

Why it matters:

Without this, professional creators using the API are forced to either spend credits blindly or abandon the API and use the browser manually — defeating the purpose of API integration entirely.

The blueprint technology already exists in Chat Mode. We're simply asking for it to be exposed via API.

Thank you for considering this.