curl --fail-with-body -X GET "$RAWCHUNKS_API/api/generation/status/$(jq -nr --arg v "$TASK_ID" '$v|@uri')?songId=$(jq -nr --arg v "$SONG_ID" '$v|@uri')"
{
"status": "<string>",
"progress": 123,
"error": "<string>",
"primaryUrl": "<string>",
"audioUrls": [
"<string>"
],
"songAId": "<string>",
"songBId": "<string>",
"duration": 123,
"durations": [
123
]
}Generation
Generation status
Poll a generation and retrieve persisted audio.
GET
/
api
/
generation
/
status
/
{taskId}
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/generation/status/$(jq -nr --arg v "$TASK_ID" '$v|@uri')?songId=$(jq -nr --arg v "$SONG_ID" '$v|@uri')"
{
"status": "<string>",
"progress": 123,
"error": "<string>",
"primaryUrl": "<string>",
"audioUrls": [
"<string>"
],
"songAId": "<string>",
"songBId": "<string>",
"duration": 123,
"durations": [
123
]
}Use
primaryUrl only when the body says status: "ready". Keep the original task/song pair. A mismatched pair returns 409.
Polling and streams.
Headers and parameters
string
required
Resource ID.
string
required
Song ID returned by the same submission.
Response (200)
Success.string
required
Values:
pending, processing, ready, error.number
Progress percentage when available.
string
string
Present on ready. Primary persisted audio URL.
string[]
string
Primary song ID on ready.
string
Optional additional result ID.
number
Decoded output duration in seconds.
number[]
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. |
500 | Request failed. |
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/generation/status/$(jq -nr --arg v "$TASK_ID" '$v|@uri')?songId=$(jq -nr --arg v "$SONG_ID" '$v|@uri')"
⌘I