curl --fail-with-body -X GET "$RAWCHUNKS_API/api/editing/status/$(jq -nr --arg v "$TASK_ID" '$v|@uri')?songId=$(jq -nr --arg v "$SONG_ID" '$v|@uri')&userAddress=$(jq -nr --arg v "$USER_ADDRESS" '$v|@uri')&task=$(jq -nr --arg v "$TASK" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS"
{
"status": "<string>",
"progress": 123,
"error": "<string>",
"take": {
"id": "<string>",
"song_id": "<string>",
"stem_id": {},
"take_number": 123,
"model": "<string>",
"task": "<string>",
"url": "<string>",
"is_active": true,
"prompt": {},
"lyrics": {},
"repainting_start": {},
"repainting_end": {},
"seed": {},
"provenance": {
"target": "<string>",
"targetStemId": {},
"region": {
"start": 123,
"end": 123
},
"regions": [
{
"start": 123,
"end": 123
}
],
"audioOffset": 123,
"outputDuration": {},
"mergedInto": "<string>",
"layerName": "<string>"
},
"created_at": "<string>"
},
"audioUrl": "<string>",
"audioUrls": [
"<string>"
],
"stems": [
{
"id": "<string>",
"song_id": "<string>",
"name": "<string>",
"url": "<string>",
"volume": 123,
"pan": 123,
"is_muted": true,
"is_solo": true,
"waveform_peaks_url": {},
"created_at": "<string>"
}
],
"versionState": "<string>"
}Editing
Edit status
Poll an edit and retrieve its candidate or stems.
GET
/
api
/
editing
/
status
/
{taskId}
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/editing/status/$(jq -nr --arg v "$TASK_ID" '$v|@uri')?songId=$(jq -nr --arg v "$SONG_ID" '$v|@uri')&userAddress=$(jq -nr --arg v "$USER_ADDRESS" '$v|@uri')&task=$(jq -nr --arg v "$TASK" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS"
{
"status": "<string>",
"progress": 123,
"error": "<string>",
"take": {
"id": "<string>",
"song_id": "<string>",
"stem_id": {},
"take_number": 123,
"model": "<string>",
"task": "<string>",
"url": "<string>",
"is_active": true,
"prompt": {},
"lyrics": {},
"repainting_start": {},
"repainting_end": {},
"seed": {},
"provenance": {
"target": "<string>",
"targetStemId": {},
"region": {
"start": 123,
"end": 123
},
"regions": [
{
"start": 123,
"end": 123
}
],
"audioOffset": 123,
"outputDuration": {},
"mergedInto": "<string>",
"layerName": "<string>"
},
"created_at": "<string>"
},
"audioUrl": "<string>",
"audioUrls": [
"<string>"
],
"stems": [
{
"id": "<string>",
"song_id": "<string>",
"name": "<string>",
"url": "<string>",
"volume": 123,
"pan": 123,
"is_muted": true,
"is_solo": true,
"waveform_peaks_url": {},
"created_at": "<string>"
}
],
"versionState": "<string>"
}Poll by the task/song/user binding. A ready candidate has
take and audioUrl; ready separation has stems. There is no edit event stream.
Follow jobs.
Headers and parameters
string
required
Resource ID.
string
required
Same song as submission.
string
required
Same selected account as submission.
string
required
Task kind returned by submission. Values:
repaint, lego, complete, extend, cover, extract.string
Same target stem if supplied.
string
Optional original prompt.
string
Optional original start, decimal seconds.
string
Optional original end, decimal seconds.
string
required
Selected account address. Required for owner-scoped reads and writes. It identifies the account; your product must authenticate its own users.
Response (200)
Success.string
required
Values:
pending, processing, ready, error.number
string
object | null
Show Properties
Show Properties
string
required
string
required
string | null
integer
string
string
string
required
boolean
required
string | null
string | null
number | null
number | null
integer | null
object | null
Show Properties
Show Properties
string
Values:
master, stem, layer.string | null
object | null
object[]
number
Source-buffer offset for the eligible section, in seconds.
number | null
string
string
string
string
string[]
object[]
string
Candidate state. Initially pending; later reads can report merged or discarded. Values:
pending, merged, discarded.Errors
Failed JSON responses contain anerror string. Check the HTTP status before reading a successful result. See job handling for interrupted or uncertain submissions.
| Status | Meaning |
|---|---|
400 | Invalid request. |
403 | Account does not match resource. |
404 | Resource not found. |
409 | Resource conflict; reload state or open an editable version. |
500 | Request failed. |
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/editing/status/$(jq -nr --arg v "$TASK_ID" '$v|@uri')?songId=$(jq -nr --arg v "$SONG_ID" '$v|@uri')&userAddress=$(jq -nr --arg v "$USER_ADDRESS" '$v|@uri')&task=$(jq -nr --arg v "$TASK" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS"
⌘I