Start a track versions generation job

POST 
/v0/tracks/versions

This endpoint allows you to start a job to generate edited versions of a track. The job will be processed asynchronously and you can check the status using the GET /tracks/versions/{jobId} endpoint. Note that the url expires in 24 hours.

Duration limits:

• The duration must be between 1 second and 5 minutes.
• Longer durations result in increased processing time, as latency scales with the desired duration.

Request

application/json

Body

Track edit request configuration

durationMs int32required
loopable boolean
trackId uuidrequired

Responses

200

Track edit job response

application/json

Schema

Schema

status string

Possible values: [PENDING, PROCESSING, COMPLETED, FAILED]

results

object[]

Array [

previewUrl string

waveform

object

version int32

channels int32

sampleRate int32

samplesPerPixel int32

bits int32

length int32

data int32[]

highQualityUrl string

]

message string
jobId uuid

Example (from schema)

{
  "status": "PENDING",
  "results": [
    {
      "previewUrl": "string",
      "waveform": {
        "version": 0,
        "channels": 0,
        "sampleRate": 0,
        "samplesPerPixel": 0,
        "bits": 0,
        "length": 0,
        "data": [
          0
        ]
      },
      "highQualityUrl": "string"
    }
  ],
  "message": "string",
  "jobId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Example

{
  "status": "PENDING",
  "results": [],
  "message": "Job is still processing",
  "jobId": "9fca9585-50f6-44b4-8a64-baf7d9016614"
}

400

Bad request.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Bad request"
}

401

Unauthorized. Most likely your access token has expired.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Invalid credentials"
}

429

Rate limit exceeded.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Rate limit exceeded"
}

Loading...