Run Intelligence | Resemble

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.

By default the request is synchronous. If you provide a callback_url, the request becomes asynchronous automatically: the API returns 202 Accepted with the newly created intelligence record, then sends the final result to your callback URL with an outbound HTTP POST.

Request Body

Field	Type	Required	Description
`media_token`	string	No*	Token for uploaded media file (from secure upload).
`url`	string	No*	HTTPS URL to media file.
`detect_id`	string	No	UUID of an existing detect to associate.
`media_type`	string	No	Explicit type: `audio`, `image`, or `video` (auto-detected if not provided).
`callback_url`	string	No	URL that receives the final intelligence payload via HTTP `POST`. When present, the request runs asynchronously and returns `202 Accepted`.

*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"
  }'

Asynchronous Example (`callback_url`)

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",
    "callback_url": "https://example.com/webhooks/intelligence"
  }'

Response

Asynchronous Response (`callback_url` provided)

When callback_url is present, the API accepts the job immediately and returns a pending intelligence record:

{
  "success": true,
  "item": {
    "uuid": "abc123...",
    "media_type": "audio",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

The final result is then delivered to your callback URL via HTTP POST.

Callback Payload

On success, the callback payload matches the normal intelligence response shape:

{
  "success": true,
  "item": {
    "uuid": "abc123...",
    "media_type": "audio",
    "description": {
      "speaker_info": "Adult male speaker",
      "language": "en",
      "dialect": "en-US",
      "emotion": "confident",
      "speaking_style": "conversational",
      "context": "Product marketing pitch",
      "message": "Introducing a new feature",
      "abnormalities": "No anomalies detected",
      "transcription": "Welcome back to the Resemble product update...",
      "translation": null,
      "misinformation": "No misinformation detected",
      "fraud": {
        "type": "none",
        "confidence": 95,
        "reasoning": "No fraud indicators detected"
      },
      "liveness": {
        "assessment": "real_person",
        "confidence": 88,
        "indicators": "Natural breathing patterns, consistent background noise"
      },
      "digitally_altered": {
        "detected": false,
        "confidence": 92,
        "alterations": "No digital alterations detected"
      }
    },
    "created_at": "2024-01-15T10:30:00Z"
  }
}

On failure, the callback includes the persisted intelligence record plus an error field:

{
  "success": false,
  "item": {
    "uuid": "abc123...",
    "media_type": "audio",
    "description": "Error generating Intelligence report.",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "error": "Gemini API request failed"
}

Audio/Video Response

{
  "success": true,
  "item": {
    "uuid": "abc123...",
    "media_type": "audio",
    "description": {
      "speaker_info": "Adult male speaker",
      "language": "en",
      "dialect": "en-US",
      "emotion": "confident",
      "speaking_style": "conversational",
      "context": "Product marketing pitch",
      "message": "Introducing a new feature",
      "abnormalities": "No anomalies detected",
      "transcription": "Welcome back to the Resemble product update...",
      "translation": null,
      "misinformation": "No misinformation detected",
      "fraud": {
        "type": "none",
        "confidence": 95,
        "reasoning": "No fraud indicators detected"
      },
      "liveness": {
        "assessment": "real_person",
        "confidence": 88,
        "indicators": "Natural breathing patterns, consistent background noise"
      },
      "digitally_altered": {
        "detected": false,
        "confidence": 92,
        "alterations": "No digital alterations detected"
      }
    },
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Notes

One of media_token or url is required.
Requests without callback_url are processed synchronously and return 200 OK.
Requests with callback_url are processed asynchronously and return 202 Accepted.
Use Get Intelligence to poll for the final result if you do not want to rely on callbacks.

Image Response

{
  "success": true,
  "item": {
    "uuid": "def456...",
    "media_type": "image",
    "description": {
      "scene_description": "Detailed description of what the image depicts",
      "subjects": "People, objects, locations identified in the image",
      "authenticity_analysis": "Visual artifacts, manipulation indicators, AI generation signs",
      "context_and_setting": "Environmental, temporal, situational context",
      "abnormalities": "Visual anomalies indicating AI generation or manipulation",
      "misinformation": "Misinformation and disinformation analysis results",
      "fraud": {
        "type": "none",
        "confidence": 90,
        "reasoning": "No fraud indicators detected"
      },
      "liveness": {
        "assessment": "real_person",
        "confidence": 85,
        "indicators": "Natural skin texture, consistent 3D geometry"
      },
      "digitally_altered": {
        "detected": false,
        "confidence": 88,
        "alterations": "No digital alterations detected"
      }
    },
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Response Fields

Audio/Video Description Fields

Field	Type	Description
`speaker_info`	string	Information about the speaker(s)
`language`	string	Detected language code
`dialect`	string	Detected dialect
`emotion`	string	Detected emotional tone
`speaking_style`	string	Speaking style classification
`context`	string	Contextual analysis of the content
`message`	string	Summary of the message conveyed
`abnormalities`	string	AI generation or manipulation anomalies
`transcription`	string	Full transcription of audio content
`translation`	string \| null	Translation if non-English content detected
`misinformation`	string	Misinformation and disinformation analysis
`fraud`	object	Fraud analysis result
`fraud.type`	string	Fraud classification: `none`, `vishing`, `impersonation`, `romance_scam`, `tech_support_scam`, `financial_fraud`, `extortion`, `political_manipulation`, `synthetic_media_fraud`, `insurance_fraud`, `employment_fraud`, `other`
`fraud.confidence`	number	Confidence score (0-100)
`fraud.reasoning`	string	Explanation of the fraud assessment
`liveness`	object	Liveness detection result
`liveness.assessment`	string	One of `real_person`, `not_real_person`, `inconclusive`
`liveness.confidence`	number	Confidence score (0-100)
`liveness.indicators`	string	Biometric liveness indicators found
`digitally_altered`	object	Digital alteration detection result
`digitally_altered.detected`	boolean	Whether manual digital editing was detected
`digitally_altered.confidence`	number	Confidence score (0-100)
`digitally_altered.alterations`	string	Description of alterations found

Image Description Fields

Field	Type	Description
`scene_description`	string	Detailed description of the image content
`subjects`	string	People, objects, and locations identified
`authenticity_analysis`	string	Visual artifacts and manipulation indicators
`context_and_setting`	string	Environmental and situational context
`abnormalities`	string	Visual anomalies indicating AI generation or manipulation
`misinformation`	string	Misinformation and disinformation analysis
`fraud`	object	Fraud analysis result
`fraud.type`	string	Fraud classification: `none`, `impersonation`, `synthetic_media_fraud`, `political_manipulation`, `insurance_fraud`, `other`
`fraud.confidence`	number	Confidence score (0-100)
`fraud.reasoning`	string	Explanation of the fraud assessment
`liveness`	object	Liveness detection result
`liveness.assessment`	string	One of `real_person`, `not_real_person`, `inconclusive`
`liveness.confidence`	number	Confidence score (0-100)
`liveness.indicators`	string	Biometric liveness indicators found
`digitally_altered`	object	Digital alteration detection result
`digitally_altered.detected`	boolean	Whether manual digital editing was detected
`digitally_altered.confidence`	number	Confidence score (0-100)
`digitally_altered.alterations`	string	Description of alterations found