Skip to main content
POST
Start a run

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.

Path Parameters

nodeId
string<uuid>
required

Body

application/json

Body

canvasId
string<uuid>
textPrompt
string
modelConfig
object
outputAspectRatio
enum<string>
Available options:
21:9,
16:9,
4:3,
5:4,
3:2,
1:1,
2:3,
3:4,
4:5,
9:16,
9:21
outputDuration
integer
Required range: x > 0
outputResolution
Available options:
360p,
480p,
540p,
580p,
720p,
1080p,
1440p,
2160p,
4k,
0.5K,
1K,
2K,
4K,
1k,
2k
seed
integer
Required range: 0 <= x <= 2147483647
numVariations
integer
Required range: 1 <= x <= 10
generateAudio
boolean
negativePrompt
string
imageUrls
string<uri>[]
Maximum array length: 15
elevenLabsVoiceId
string
Minimum string length: 1
customVoiceId
string<uuid>
elevenLabsVoiceSettings
object

Response

201

id
string<uuid>
required
Last modified on July 17, 2026