Skip to main content
PUT
/
v1
/
adapt.auto_cut_down
adapt.auto_cut_down
curl --request PUT \
  --url https://api.soundpiece.co/v1/adapt.auto_cut_down \
  --header 'Content-Type: application/json' \
  --data '
{
  "idempotency_key": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source": {
    "url": "<string>"
  },
  "target_duration": 123,
  "callback_url": "<string>"
}
'
{
  "auto_cut": {
    "id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "idempotency_key": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "source": {
      "url": "<string>"
    },
    "target_duration": 123,
    "output": {
      "url": "<string>",
      "expires_at": "2023-11-07T05:31:56Z",
      "duration": 123
    },
    "error": {
      "message": "<string>"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.soundpiece.co/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
idempotency_key
string<uuid>
required

A unique UUID you choose. Send the same key to retry safely; we'll return the original response without doing the work again.

source
AudioSource · object
required

The audio source to operate on.

target_duration
number
required

The desired output duration in seconds. The result may be slightly shorter or longer to land on a natural cut point.

callback_url
string<uri> | null

Optional HTTPS URL we'll POST the final response to when the operation reaches ready or failed. Polling remains the canonical source of truth; webhooks are a best-effort latency optimisation.

Required string length: 1 - 2048

Response

Successful Response

auto_cut
AutoCut · object
required