Video Projects

Add a text clip to a track

post/v1/video-projects/{projectId}/tracks/{trackId}/clips/text

Request

  • Base URL: https://api.neume.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.neume.io/v1/video-projects/{projectId}/tracks/{trackId}/clips/text
  • Auth: none declared

Path parameters

projectIdstring required
trackIdstring required

Request body

startTimenumber required

Start time in seconds

durationnumber required

Duration in seconds (min 0.5)

textstring required

Text content

textStylestring

Style: title | subtitle | caption

textPositionstring

Position: top | center | bottom

fontColorstring

Font color hex

backgroundColorstring

Background color hex (with optional alpha)

fontFamilystring

Font family name

fontSizenumber

Font size in px

fontWeightnumber

Font weight

textAlignstring

Text alignment: left | center | right

letterSpacingnumber

Letter spacing in em

lineHeightnumber

Line height multiplier

strokeColorstring

Stroke color hex

strokeWidthnumber

Stroke width in px

posXnumber

X position on canvas

posYnumber

Y position on canvas

rotationnumber

Rotation in degrees

Response

clipIdstring required

Clip ID

trackIdstring required

Track ID

type'VIDEO' | 'AUDIO' | 'TEXT' | 'IMAGE' | 'CAPTION' required

Clip type

startTimenumber required

Start time in seconds

durationnumber required

Duration in seconds

zIndexnumber required

Layer order for overlapping clips (higher = on top)

posXnumber

X position on canvas

posYnumber

Y position on canvas

widthnumber

Width on canvas

heightnumber

Height on canvas

rotationnumber

Rotation in degrees

opacitynumber

Opacity 0.0-1.0

scaleXnumber

Scale X

scaleYnumber

Scale Y

transitionobject

Transition to next clip

captionWordsobject

Word-level captions JSON

captionStylestring

Caption style preset name

promptstring

Scene description prompt

imageUrlstring

Source image URL

imageStatus'PENDING' | 'STARTING' | 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED'

Image generation status

videoUrlstring

Generated video URL

videoStatus'PENDING' | 'STARTING' | 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED'

Video generation status

videoProgressnumber

Video generation progress 0-100

videoDurationnumber

Duration of generated video in seconds

videoPromptstring

Prompt used for video generation

videoGenType'NORMAL' | 'LIPSYNC' | 'MOTION_CONTROL'

Video generation type

motionVideoPathstring

S3 path for motion reference video (MOTION_CONTROL only)

audioSyncboolean required

Whether to sync with audio during generation

textstring

Text content (text clips)

textStylestring

Text style: title | subtitle | caption

textPositionstring

Text position: top | center | bottom

fontColorstring

Font color hex

backgroundColorstring

Background color hex

fontFamilystring

Font family

fontSizenumber

Font size in px

fontWeightnumber

Font weight (300-700)

textAlignstring

Text alignment: left | center | right

letterSpacingnumber

Letter spacing in em

lineHeightnumber

Line height multiplier

strokeColorstring

Stroke color hex

strokeWidthnumber

Stroke width in px

enterAnimationobject

Enter animation config

exitAnimationobject

Exit animation config

songIdstring

Song ID for audio clips

songTitlestring

Song title

audioUrlstring

Direct audio file URL (uploaded audio assets)

trimStartnumber

Trim start in seconds

trimEndnumber

Trim end in seconds

createdAtstring date-time required

Creation date

Changes

No recorded changes to this operation across all 2 revisions of this API.