Create Task
url, an s3:// URI with a storageIntegrationId, or an assetId from a previous upload.
Examples
Separate vocals and instrumental:Checking results
Tasks process asynchronously. The response returns a Taskid you can use to check progress:
Task is created
processing status.Check for completion
status. When a target finishes, its status becomes completed (with output download links) or error.Authorizations
Body
- Option 1
- Option 2
Asset ID of an input media file
One or more model targets to process
1 - 20 elementsID of a configured storage integration. Required when using an S3 input url or a custom writeDestination. See Custom S3 Write Destination.
Optional. S3 URI prefix to write outputs under (e.g. "s3://my-bucket/outputs"). Requires storageIntegrationId. The source 'url' must also have an S3 URI prefix (s3://...). The bucket must be covered by a configured storage integration. Outputs are written under //*. Use output[].link for exact object locations. See Custom S3 Write Destination.
Optional. Webhook URL to notify when this Task completes. Overrides the global webhook URL configured in the dashboard for this Task only. See Using Webhooks.
Client-provided metadata. Stored and returned as-is in responses and webhooks.
4096Response
Default Response
Unique identifier of the Task
Timestamp of when the Task was created
Timestamp of when the Task was completed
Unique identifier of the client
Processing cost in credits
Asset ID of an input media file. Mutually exclusive with url
URL of an input media file (HTTPS or s3://). Mutually exclusive with assetId
ID of the storage integration used to read the S3 input and write outputs. Only present when a storage integration was provided.
S3 URI prefix outputs were written under. The source 'url' must also have an S3 URI prefix (s3://...). Outputs are written under //*. Use output[].link for exact object locations. Only present when a custom write destination was provided.
Client-provided metadata. Stored and returned as-is in responses and webhooks.
Processing targets and their current status