Safety & DetectionIntelligence

Run Intelligence

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

Analyzes a media file and returns comprehensive intelligence. The API auto-detects whether the input is audio, video, or image.

Request Body

FieldTypeRequiredDescription
media_tokenstringNo*Token for uploaded media file (from secure upload).
urlstringNo*HTTPS URL to media file.
detect_idstringNoUUID of an existing detect to associate.
media_typestringNoExplicit type: audio, image, or video (auto-detected if not provided).
jsonbooleanNoReturn description as JSON. Default: false for audio/video, true for images.

*One of media_token or url is required.

Example

$curl --request POST 'https://app.resemble.ai/api/v2/intelligence' \
>  -H 'Authorization: Bearer YOUR_API_TOKEN' \
>  -H 'Content-Type: application/json' \
>  --data '{
>    "url": "https://example.com/media/sample.wav",
>    "json": true
>  }'

Response

Audio/Video Response (json=true)

1{
2  "success": true,
3  "item": {
4    "uuid": "abc123...",
5    "media_type": "audio",
6    "description": {
7      "speaker_info": "Adult male speaker",
8      "language": "en",
9      "dialect": "en-US",
10      "emotion": "confident",
11      "speaking_style": "conversational",
12      "context": "Product marketing pitch",
13      "message": "Introducing a new feature",
14      "abnormalities": "No anomalies detected",
15      "transcription": "Welcome back to the Resemble product update...",
16      "translation": null,
17      "misinformation": "No misinformation detected"
18    },
19    "created_at": "2024-01-15T10:30:00Z"
20  }
21}

Image Response (json=true, default for images)

1{
2  "success": true,
3  "item": {
4    "uuid": "def456...",
5    "media_type": "image",
6    "description": {
7      "scene_description": "Detailed description of what the image depicts",
8      "subjects": "People, objects, locations identified in the image",
9      "authenticity_analysis": "Visual artifacts, manipulation indicators, AI generation signs",
10      "context_and_setting": "Environmental, temporal, situational context",
11      "abnormalities": "Visual anomalies indicating AI generation or manipulation",
12      "misinformation": "Misinformation and disinformation analysis results"
13    },
14    "created_at": "2024-01-15T10:30:00Z"
15  }
16}