`audio`

Live radio, a podcast episode or a sound.

Version 1 · schema audio.v1.schema.json

Layouts

Every card type has full. Pick a layout with the element's layout attribute, render.layout, or a theme.

Fields

The fields of card.data. Values a source doesn't provide are null; new optional fields can appear within version 1.

Field	Type	Required	Notes
`kind`	`enum`	yes	live_radio · podcast_episode · sound
`title`	`string`	yes
`subtitle`	`string \| null`	yes
`stream_url`	`url`	yes
`artwork_url`	`url \| null`	yes	WebKnox media URL: https://webknox.com/media/v1/<host>/<path>. Treat it as opaque.
`duration_s`	`integer \| null`	yes	null for live streams.
`live`	`boolean`	yes	No seeking when true.
`credit`	`string \| null`	yes	Required attribution for the recording, if any.

Example

A recorded answer to “Play some jazz”. Open it in the Answer Lab to see every layout and style.

Response

1{
2  "v": 2,
3  "id": "ans_rk37q8hqy1cqzpyb",
4  "matched": true,
5  "locale": "en",
6  "skill": "radio",
7  "confidence": 0.9,
8  "text": "Here's Classic Vinyl HD. https://icecast.walmradio.com:8443/classic",
9  "speech": "Here's Classic Vinyl HD.",
10  "card": {
11    "type": "audio",
12    "version": 1,
13    "data": {
14      "kind": "live_radio",
15      "title": "Classic Vinyl HD",
16      "subtitle": "1930 · 1940 · 1950",
17      "stream_url": "https://icecast.walmradio.com:8443/classic",
18      "artwork_url": null,
19      "duration_s": null,
20      "live": true,
21      "credit": null
22    }
23  },
24  "sources": [
25    {
26      "name": "radio-browser.info",
27      "url": "https://walmradio.com/classic",
28      "license": null
29    }
30  ],
31  "follow_ups": [],
32  "actions": [],
33  "usage": {
34    "billable": true
35  }
36}