Clips

Add a sound effect to a clip

Adds a sound effect to a clip from Tella's curated catalog (presetId) or your own audio (sourceId).

post/v1/videos/{id}/clips/{clipId}/sound-effects

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/videos/{id}/clips/{clipId}/sound-effects
  • Auth: HTTP bearer

Path parameters

idstring required

Video identifier

Example:vid_abc123def456
clipIdstring required

Clip identifier

Example:cl_xyz789ghi012

Request body

durationMsinteger required
namestring
presetIdstring

Preset ID of a curated Tella sound effect, from a default item in GET /v1/library?scope=default. Placing one copies the effect into a source owned by your workspace, so nothing needs uploading. Mutually exclusive with sourceId; exactly one is required.

sourceIdstring

Source ID for the audio, from POST /v1/sources (kind: audio with the audio's duration) or from a private/workspace item in GET /v1/library?type=sound-effect. When uploading, send the audio file as-is — MP3, WAV, M4A, … — no need to wrap it in an MP4. Mutually exclusive with presetId; exactly one is required.

startTimeMsinteger required

Start time. Milliseconds on the clip playback timeline (with cuts applied) — the same timeline as the cut transcript.

volumenumber

Playback volume (0 = muted, 1 = original). Defaults to 1.

Example request

{
  "durationMs": 3000,
  "name": "Whoosh",
  "presetId": "cha-ching",
  "sourceId": "su_abc123",
  "startTimeMs": 1000,
  "volume": 1
}

Response

OK

Example response

{
  "soundEffect": {
    "durationMs": 3000,
    "id": "ly_abc123",
    "name": "Whoosh",
    "sourceId": "su_abc123",
    "startTimeMs": 1000,
    "volume": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.