Sign in

v1

latestOpenAPI 3.1.0Proprietary2026-07-267018.1 KB
tasks

Create Task

post/tasks

Request body

OR

Example request

{
  "assetId": "your_asset_id",
  "targets": [
    {
      "model": "vocals",
      "formats": [
        "wav"
      ]
    },
    {
      "model": "instrumental",
      "formats": [
        "wav"
      ]
    }
  ]
}

Response

Default Response

idstring

Unique identifier of the Task

createdAtstring date-time

Timestamp of when the Task was created

completedAtstring date-time nullable

Timestamp of when the Task was completed

clientIdstring

Unique identifier of the client

costnumber

Processing cost in credits

assetIdstring

Asset ID of an input media file. Mutually exclusive with url

urlstring nullable

URL of an input media file. Mutually exclusive with assetId

writeDestinationstring nullable

S3 URI prefix outputs were written under. Outputs are organized as <writeDestination>/<taskId>/targets/<targetId>/output/<filename>. Only present when a custom write destination was provided.

metadatastring

Client-provided metadata. Stored and returned as-is in responses and webhooks.