Skip to main content
Version: 2.0.0

Create Audio Intelligence

Analyzes an audio file and provides comprehensive insights.

HTTP Request

POST https://app.resemble.ai/api/v2/audio_intelligence

Request Body

ParameterTypeDescription
urlstringURL of the audio file to analyze
jsonboolean(Optional) If true, returns a structured JSON response

Response

If json is not set or false, returns an AudioIntelligenceResponse object with a description string.

If json is set to true, returns an AudioIntelligenceJSONResponse object with structured data.

Response Fields

FieldTypeDescription
successbooleanIndicates whether the operation was successful
itemobjectContains the analysis results
descriptionstring or objectAnalysis results as a string or structured object
created_atstringTimestamp of when the analysis was created

When json is true, the description field contains the following structured data:

FieldTypeDescription
speaker_infostringInformation about the speaker's characteristics
languagestringDetected language of the audio
dialectstringDetected dialect or accent
emotionstringDetected emotion in the speech
speaking_stylestringAnalysis of the speaking style
contextstringContextual information about the audio content
messagestringMain message or purpose of the audio content
transcriptionstringFull transcription of the audio
translationstring or nullTranslation of the content (if applicable)

Example

curl --request POST \
--url https://app.resemble.ai/api/v2/audio_intelligence \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-type: application/json' \
--data '{
"url": "https://example.com/audio/sample.wav",
"json": true
}'

Replace YOUR_API_KEY with your actual Resemble AI API key.

Authentication

All API requests require authentication using a bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Ensure that you provide a valid URL and that the audio file is in a supported format.