Creates an outline, either from a topic (prompt) or from an existing video (videoId). Send exactly one of the two — never both. An outline is a stored, editable resource: generate chapters, review them, expand them into a script, then build a video. Counts against the account's video creation limit.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
An outline is a stored, editable plan for a video. Creating one is the first step of the
prompt → video flow, and it replaces the retired
POST /gpt/generate-outline.
Send either prompt or videoId, never both:
prompt— a topic, 8–400 characters after trimming. Use this to build something new.videoId— an existing video. Use this to plan changes against a video you already have.
The response is an empty outline with no chapters yet. Generate them with
Generate chapters.
This counts against your video creation limit
Even though no video exists yet, outline creation consumes the same 8-hour rolling quota as
POST /videos— 50 per 8 hours on free accounts, 1000 on paid, 6000 on Enterprise. A 429
here means the quota, not a rate limit.
quizSettings is optional and only shapes later quiz generation; you can also set it any time
with Update an outline.