Sign in
latestOpenAPI 3.1.12026-08-22330162.7 KB

35448566f143

Tools

Write a video script from a topic

Generates 2 distinct narration script variations for a topic, sized to your target duration. Pick the one you like (or edit it) and pass it to POST /videos/generate as the script with inputType: "script".

Cost: 1 credit per minute of target duration (minimum 1 credit).

post/scripts

Request body

promptstring required

The topic or idea to write a script about. Example: "5 mind-blowing facts about the deep ocean".

durationnumber required

Target video duration in seconds (15-1200). The script length is sized so narration fits this duration.

languagestring

Language for the script (ISO 639-1 code like "en", "es", "hi"). Default: English.

source'tool_page' | 'inline'

Where the request came from, for analytics only. Dashboard use; safe to omit.

templateIdstring

Creation template the request came from, for analytics only. Dashboard use; safe to omit.

Response

OK

providerstring required

Which AI model wrote the scripts.

creditsUsednumber required

Credits deducted for this generation.

successboolean required