{
"id": "<string>",
"title": "<string>",
"url": "<string>",
"creator": "<string>",
"duration": 123,
"isCreator": true,
"paymentIntentId": {},
"streamPriceUsd": 123,
"streamPriceWei": "<string>"
}Songs and takes
Open paid playback
Authorize song playback and receive its audio URL.
GET
/
api
/
songs
/
{id}
/
stream
{
"id": "<string>",
"title": "<string>",
"url": "<string>",
"creator": "<string>",
"duration": 123,
"isCreator": true,
"paymentIntentId": {},
"streamPriceUsd": 123,
"streamPriceWei": "<string>"
}Authorize song playback and receive its audio URL.
Paid requests accept USDC session or Credits headers. Use the selected account consistently in headers and creator fields.
For Credits, send
string
For USDC:
Bearer followed by the complete issued session token.x-wallet-auth-token and x-credit-source (card or promo). A stable x-idempotency-key of at most 80 characters identifies a paid service operation.
Path and headers
string
required
Song ID.
string
Use
application/json for metadata; otherwise the response redirects to audio.JSON response
string
Song and playable media.
string
Song and playable media.
string
Song and playable media.
string
Song and playable media.
number
Seconds.
boolean
Whether the listener is exempt as the creator.
string or null
Save for checkpoints.
number
Price per minute; zero for an exempt creator.
string
Six-decimal rate.
Playback billing
Use a USDC session or purchased Credits. Promo Credits cannot fund listening./api/stream/{id} is an alias. Submit checkpoints as listening progresses.⌘I