curl --fail-with-body -X GET "$RAWCHUNKS_API/api/songs/$(jq -nr --arg v "$ID" '$v|@uri')"
{
"song": {
"id": "<string>",
"title": "<string>",
"creator": "<string>",
"url": "<string>",
"created_at": "<string>",
"family": {},
"basis": {},
"source": {},
"metadata_cid": {},
"image": {},
"album_id": {},
"network": {},
"chain_song_id": {},
"tx_hash": {},
"version": 123,
"licenses": 123,
"stream_price": 123,
"license_price": 123,
"duration": {},
"tags": [
"<string>"
],
"public": true
},
"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>"
}
],
"takes": [
{
"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>"
}
]
}Songs and takes
Read a song project
Read a song with its stems and takes.
GET
/
api
/
songs
/
{id}
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/songs/$(jq -nr --arg v "$ID" '$v|@uri')"
{
"song": {
"id": "<string>",
"title": "<string>",
"creator": "<string>",
"url": "<string>",
"created_at": "<string>",
"family": {},
"basis": {},
"source": {},
"metadata_cid": {},
"image": {},
"album_id": {},
"network": {},
"chain_song_id": {},
"tx_hash": {},
"version": 123,
"licenses": 123,
"stream_price": 123,
"license_price": 123,
"duration": {},
"tags": [
"<string>"
],
"public": true
},
"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>"
}
],
"takes": [
{
"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>"
}
]
}Public songs can be read without an account header. Private songs require the owner’s
x-session-user-address. public controls catalog visibility, not media encryption.
Headers and parameters
string
required
Resource ID.
Response (200)
Success.object
required
Show Properties
Show Properties
string
required
string
required
string
required
string
required
string
string | null
string | null
string | null
string | null
string | null
string | null
string | null
string | null
string | null
integer
integer
number
Listed USDC per minute.
number
Listed USDC per license.
number | null
Seconds.
string[]
boolean
Catalog visibility. Media URLs are not private storage.
object[]
required
object[]
required
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
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/songs/$(jq -nr --arg v "$ID" '$v|@uri')"
⌘I