Get chat audio | Hume API

Fetches the audio of a previous Chat. For more details, see our guide on audio reconstruction here.

Authentication

X-Hume-Api-Keystring

API Key authentication via header

Path parameters

idstringRequiredformat: "uuid"

Identifier for a chat. Formatted as a UUID.

Response

Success

idstring

Identifier for the chat. Formatted as a UUID.

user_idstring

Identifier for the user that owns this chat. Formatted as a UUID.

statusenum

Indicates the current state of the audio reconstruction job. There are five possible statuses:

QUEUED: The reconstruction job is waiting to be processed.
IN_PROGRESS: The reconstruction is currently being processed.
COMPLETE: The audio reconstruction is finished and ready for download.
ERROR: An error occurred during the reconstruction process.
CANCELED: The reconstruction job has been canceled.

Indicates the current state of the audio reconstruction job. There are five possible statuses: - `QUEUED`: The reconstruction job is waiting to be processed. - `IN_PROGRESS`: The reconstruction is currently being processed. - `COMPLETE`: The audio reconstruction is finished and ready for download. - `ERROR`: An error occurred during the reconstruction process. - `CANCELED`: The reconstruction job has been canceled.

Allowed values:

filenamestring or null

Name of the chat audio reconstruction file.

modified_atlong or null

The timestamp of the most recent status change for this audio reconstruction, formatted milliseconds since the Unix epoch.

signed_audio_urlstring or null

Signed URL used to download the chat audio reconstruction file.

signed_url_expiration_timestamp_millislong or null

The timestamp when the signed URL will expire, formatted as a Unix epoch milliseconds.

1	{
2	"id": "470a49f6-1dec-4afe-8b61-035d3b2d63b0",
3	"user_id": "e6235940-cfda-3988-9147-ff531627cf42",
4	"status": "COMPLETE",
5	"filename": "e6235940-cfda-3988-9147-ff531627cf42/470a49f6-1dec-4afe-8b61-035d3b2d63b0/reconstructed_audio.mp4",
6	"modified_at": 1729875432555,
7	"signed_audio_url": "https://storage.googleapis.com/...etc.",
8	"signed_url_expiration_timestamp_millis": 1730232816964
9	}

1	import { HumeClient } from "hume";
2
3	const client = new HumeClient({ apiKey: "YOUR_API_KEY" });
4	await client.empathicVoice.chats.getAudio("470a49f6-1dec-4afe-8b61-035d3b2d63b0");