Rewrite speech with instructions

Rewrites the speech on the named drafts following explicit instructions. Use this when you know what you want changed; use regenerate-speech to apply a named enhancement instead.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Rewrites the speech on the named drafts following explicit instructions. Use this when you know
what you want changed; use Regenerate speech to regenerate from
the chapter instead.

instructions is an array and all entries are applied together, so you can compose:

{
  "draftIds": [1, 2],
  "instructions": [
    "Shorten to roughly 30 seconds of narration.",
    "Drop the jargon — this is for a general audience."
  ]
}

Both draftIds and instructions must be non-empty. Unknown fields are rejected.

This is the outline-level equivalent of Rewrite speech for slides, which
operates on a video that already exists.

Path Params
string
required

Id of the outline.

Body Params
draftIds
array of integers
required
length ≥ 1

Ids of the outline drafts to act on. Must not be empty.

draftIds*
instructions
array of strings
required
length ≥ 1

One or more instructions, applied together. Free-form text.

instructions*
config
object
Responses

draftIds or instructions missing or empty, or an unknown field was included.

llmDisabled is set, or a non-paid organization has used its 5000-token allowance.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json