> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rawchunks.space/llms.txt
> Use this file to discover all available pages before exploring further.

# Open paid playback

> Authorize song playback and receive its audio URL.

Authorize song playback and receive its audio URL.

Paid requests accept [USDC session or Credits headers](https://docs.rawchunks.space/dev/guides/payments.md). Use the selected account consistently in headers and creator fields.

**Authorization** `string`

For USDC: `Bearer` followed by the complete issued session token.

For Credits, send `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

**id** `string` *required*

Song ID.

**Accept** `string`

Use `application/json` for metadata; otherwise the response redirects to audio.

## JSON response

**id** `string`

Song and playable media.

**title** `string`

Song and playable media.

**url** `string`

Song and playable media.

**creator** `string`

Song and playable media.

**duration** `number`

Seconds.

**isCreator** `boolean`

Whether the listener is exempt as the creator.

**paymentIntentId** `string or null`

Save for checkpoints.

**streamPriceUsd** `number`

Price per minute; zero for an exempt creator.

**streamPriceWei** `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](https://docs.rawchunks.space/dev/endpoints/library/checkpoint.md) as listening progresses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.