cURL
OPERATION_ID="op_01m3vcs7e0f8rsq32d5sqhmetw" # the "id" from the submit response
curl --request GET \
--url "https://api.soundpiece.co/v1/create.remix_instrumental?id=${OPERATION_ID}&wait=true" \
--header 'Authorization: Bearer <token>'import requests
operation_id = "op_01m3vcs7e0f8rsq32d5sqhmetw" # the "id" from the submit response
url = f"https://api.soundpiece.co/v1/create.remix_instrumental?id={operation_id}&wait=true"
headers = {"Authorization": "Bearer <token>"}
# The timeout is longer than the 20-second long poll.
response = requests.get(url, headers=headers, timeout=30)
print(response.json())const operationId = "op_01m3vcs7e0f8rsq32d5sqhmetw"; // the "id" from the submit response
const response = await fetch(`https://api.soundpiece.co/v1/create.remix_instrumental?id=${operationId}&wait=true`, {
headers: {Authorization: "Bearer <token>"},
});
console.log(await response.json());{
"remixed_instrumental": {
"id": "op_01m3vcs7e0f8rsq32d5sqhmetw",
"status": "processing",
"created_at": "2026-10-01T09:30:00Z",
"idempotency_key": "3f2b8c1e-9d4a-4e7b-b6c5-1a2d3e4f5a6b",
"n_variations": 2,
"prompt": "Dreamy, melancholic synthwave, mid-tempo",
"outputs": null,
"error": null
}
}Create
create.remix_instrumental (poll)
Fetch the current state of an instrumental remix request.
Pass ?wait=true to long-poll for up to 20 seconds, returning early once
the operation reaches ready or failed.
GET
/
v1
/
create.remix_instrumental
cURL
OPERATION_ID="op_01m3vcs7e0f8rsq32d5sqhmetw" # the "id" from the submit response
curl --request GET \
--url "https://api.soundpiece.co/v1/create.remix_instrumental?id=${OPERATION_ID}&wait=true" \
--header 'Authorization: Bearer <token>'import requests
operation_id = "op_01m3vcs7e0f8rsq32d5sqhmetw" # the "id" from the submit response
url = f"https://api.soundpiece.co/v1/create.remix_instrumental?id={operation_id}&wait=true"
headers = {"Authorization": "Bearer <token>"}
# The timeout is longer than the 20-second long poll.
response = requests.get(url, headers=headers, timeout=30)
print(response.json())const operationId = "op_01m3vcs7e0f8rsq32d5sqhmetw"; // the "id" from the submit response
const response = await fetch(`https://api.soundpiece.co/v1/create.remix_instrumental?id=${operationId}&wait=true`, {
headers: {Authorization: "Bearer <token>"},
});
console.log(await response.json());{
"remixed_instrumental": {
"id": "op_01m3vcs7e0f8rsq32d5sqhmetw",
"status": "processing",
"created_at": "2026-10-01T09:30:00Z",
"idempotency_key": "3f2b8c1e-9d4a-4e7b-b6c5-1a2d3e4f5a6b",
"n_variations": 2,
"prompt": "Dreamy, melancholic synthwave, mid-tempo",
"outputs": null,
"error": null
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
A unique identifier for an operation, prefixed op_. Returned from any PUT endpoint; pass it to the matching GET to poll, or use it to correlate webhook deliveries with your records.
Pattern:
^op_[0-9a-z]{26}$Example:
"op_01m3vcs7e0f8rsq32d5sqhmetw"
If true, long-poll for up to 20 seconds waiting for the operation to reach ready or failed.
Response
Successful Response
Show child attributes
Show child attributes