Skip to main content
POST
Prepare a Cast video

Authorizations

Authorization
string
header
required

A Melius API key (mel_...), sent as Authorization: Bearer <key>.

x-team-id
string
header
required

The team (workspace) to act on. Defaults to the key's team when omitted.

Body

application/json

Body

avatar
object
required
sections
object[]
required
Required array length: 1 - 30 elements
voice
object
voiceName
string
Maximum string length: 200
otherAvatars
object[]
Required array length: 1 - 2 elements
tone
string
Required string length: 1 - 200
engine
enum<string>
default:seedance
Available options:
seedance
resolution
Available options:
360p,
480p,
540p,
580p,
720p,
480P,
768P,
1080P,
1080p,
1440p,
2160p,
4k,
0.5K,
1K,
2K,
4K,
1k,
2k
subtitles
object
creationSettings
object
scriptTemplate
object
backgroundId
string<uuid>
propAssetId
string<uuid>
propName
string
Maximum string length: 200
props
object[]
Required array length: 1 - 6 elements
aspectRatio
enum<string>
default:9:16
Available options:
21:9,
20:9,
19.5:9,
2:1,
16:9,
3:2,
4:3,
5:4,
1:1,
4:5,
3:4,
2:3,
9:16,
1:2,
9:19.5,
9:20,
9:21
workId
string<uuid>

Response

200

attemptId
string<uuid>
required
input
object
required
review
object
required
scriptSeconds
number
required
Required range: x >= 0
aspectRatios
enum<string>[]
required
Available options:
21:9,
20:9,
19.5:9,
2:1,
16:9,
3:2,
4:3,
5:4,
1:1,
4:5,
3:4,
2:3,
9:16,
1:2,
9:19.5,
9:20,
9:21
status
enum<string>
required
Available options:
ready
estimatedCredits
number
required
Required range: x >= 0
preparationToken
string<uuid>
estimatedWait
string
visualsUnavailableReason
string