Analyse audio or a music track
What a recording contains, as data: detect (music / speech / singing / silence timeline and tags) and, for music, the tracked beats and bars, drum hits with accent, bass and lead notes, key, sections with energy and the salient moments.
Up to 20 minutes. Asynchronous — 202 with an analysis at queued; poll GET /audio-analyses/{analysisId}. 200 when the same source already has an analysis (returned, free). PRICED per second of audio (about 1 credit per minute); library tracks are free; a failed analysis is refunded.
Authorization
bearerAuth Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/audio-analyses" \ -H "Content-Type: application/json" \ -d '{}'{
"data": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"status": "queued",
"source": {
"kind": "media_asset",
"media_asset_id": "f83c59c2-d228-4515-88d6-11fa95820958",
"track_id": "89443c0f-6172-4ccb-98e3-b20b8a4e4aba"
},
"duration_sec": 0,
"credits_charged": 0,
"features_url": "http://example.com",
"error": "string",
"created_at": "string",
"completed_at": "string",
"result": {
"property1": null,
"property2": null
},
"events": {
"property1": [
{
"property1": null,
"property2": null
}
],
"property2": [
{
"property1": null,
"property2": null
}
]
},
"reused": true,
"note": "string"
}
}{
"data": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"status": "queued",
"source": {
"kind": "media_asset",
"media_asset_id": "f83c59c2-d228-4515-88d6-11fa95820958",
"track_id": "89443c0f-6172-4ccb-98e3-b20b8a4e4aba"
},
"duration_sec": 0,
"credits_charged": 0,
"features_url": "http://example.com",
"error": "string",
"created_at": "string",
"completed_at": "string",
"result": {
"property1": null,
"property2": null
},
"events": {
"property1": [
{
"property1": null,
"property2": null
}
],
"property2": [
{
"property1": null,
"property2": null
}
]
},
"reused": true,
"note": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}