Skip to main content
POST
Start 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.

Headers

idempotency-key
string

A case-sensitive key for one intended submission: 1–255 ASCII letters, digits, periods, underscores, colons or hyphens. Reuse it for identical retries; use a fresh key for a new run.

Required string length: 1 - 255
Pattern: ^[A-Za-z0-9._:-]+$

Body

application/json

Body

attemptId
string<uuid>
required
input
object
required
preparationToken
string<uuid>
expectedEstimatedCredits
number
Required range: x >= 0

Response

200

generationId
string<uuid>
required
canvasId
string<uuid>
required
bulkNodeRunId
string<uuid>
required
videoNodeId
string<uuid>
required
status
enum<string>
required
Available options:
submitting