Skip to main content
POST
Synthesise one original script from up to ten reference videos or transcripts.

Authorizations

Authorization
string
header
required

A workspace API key.

Body

application/json
sources
object[]
required

One to ten references. url is fetched and transcribed for you; transcript is used as sent.

Required array length: 1 - 10 elements
instructions
string
required

What the new script should do differently.

Required string length: 1 - 4000
projectId
string
required

The project to file this work under. Required — create one with POST /v1/projects. A project this workspace does not own answers not_found; the work is never silently filed somewhere else.

Required string length: 1 - 200
language
string
Required string length: 1 - 60
outputFormat
enum<string>
Available options:
script,
scenes
targetPlatform
enum<string>
Available options:
tiktok,
reels,
shorts,
youtube,
twitter,
general
niche
string
Maximum string length: 200
suggestedDurationSeconds
integer
Required range: 5 <= x <= 3600

Response

Success.

success
boolean
required
{key}
any