Resemble AI

Detect whether media (audio, image, or video) at a public HTTPS URL is a deepfake / AI-generated. Polls to completion and returns the verdict label, confidence score, and full result. Optional flags add media intelligence, audio source tracing, visualization, reverse image search (images), out-of-distribution detection, and zero-retention (auto-delete media after analysis). model_type: auto | image | talking_head.

Fetch a detection by UUID, polling until it completes (bounded). Use after detect_deepfake when a long job exceeded its wait budget.

Detect whether TEXT (an essay, email, post, review, comment, article) was written by an AI language model. Needs at least 25 words: shorter text comes back as prediction 'uncertain' with no model call - concatenate several messages from the same author to reach the minimum. Returns prediction ('ai' | 'human'), confidence (how sure the model is of that prediction; it is NOT an AI probability, so 'human' at 0.95 means strongly human), and the full result. Only the first ~400 words are read; chunk longer documents. A result can take several minutes when the model is cold or jobs are queued - if status is still 'processing' when the wait budget ends, resume with get_text_detection(uuid). Detection is probabilistic, not proof of authorship.

Fetch a text detection by UUID, polling until it completes (bounded). Use after detect_ai_text returned status 'processing' - typically a cold start.

Analyze media for structured intelligence: transcription, translation, language, speaker info, emotion, scene description, abnormalities, and misinformation analysis. media_type: auto | audio | video | image.

Ask a natural-language question about a COMPLETED detection (e.g. 'how confident is the model that this is fake?'). Returns the grounded answer.

Check whether media at a public HTTPS URL carries a Resemble invisible watermark (audio-first; per-channel verdict for audio).

Embed an invisible Resemble provenance watermark into media (audio-first) and return the watermarked media URL. strength 0.0-1.0 (image/video only).

Get the audio source-tracing report for a detection (which AI platform generated the fake audio). Only available when detection ran with audio_source_tracing and labeled the audio fake.

List the managed Detect Agents — investigators that wrap detection in a multi-step workflow ending in a written assessment. Returns each agent's preset_id plus this team's run allowance (free_runs_remaining, entitled), which is worth checking before starting a run.

Takes no parameters.

Run a managed Detect Agent investigation against media at a public HTTPS URL and return its verdict. preset_id is one of: investigate_social_content, review_insurance_claim, verify_breaking_news, verify_document, verify_evidence, verify_id (confirm with list_detect_agents). query states the investigation objective; check_urls adds URLs for the agent to check. Consumes a run of the team's allowance. `label`/`score` are the Detect evidence and are the only basis for an authenticity claim; `verdict` is the agent's written assessment. If timed_out is true the investigation is still running server-side — retrieve it later with get_detect_agent_run.

Fetch a persisted Detect Agent investigation by run_id, including its full event transcript. Use after run_detect_agent_investigation reported timed_out, or to re-read an earlier investigation.

List this team's Agent Detection integrations. Agent Detection tells a website whether each visitor is a person or an AI agent (for example a personal assistant browsing on someone's behalf). Each integration is one website, with the domains its publishable key works on and the one-line script snippet to paste into the site's <head>.

Takes no parameters.

Create an Agent Detection integration for a website and return its publishable key (pk_live_...) and the script snippet to install. domain is the site's domain, e.g. example.com. If the team already has an integration for that domain, the existing one is returned instead of a duplicate. The publishable key is safe to put in a public web page: it only sends telemetry, only from the listed domains. Never put the Resemble API key in a page. Paste the snippet into the <head> of every page to cover; the page can then listen for the 'resemble:verdict' event or call ResembleAgentDetection.onVerdict().

Replace the list of domains an Agent Detection integration's publishable key is valid on (for example to add a staging or www host), and optionally rename it. domains replaces the whole list, so include every domain to keep; at least one is required.

Summarise who is visiting a website: people vs AI agents. Returns totals (visits, decided, agents, people, agent_share, gated), counts per visitor class (human, computer_use_agent, browser_automation, scripted_client), and breakdowns by page, day, and network. Use this to show how much traffic comes from agents and which pages they use, so the site can be made easier for helpful agents and protected from harmful ones. Filters are optional: site_id (one integration), settled ('human' or 'agent'), page_path, and since/until as ISO 8601 times. agent_share is agents / decided visits, or null when nothing is decided yet.

List individual website visits, newest first, each with its verdict (settled: human, agent, or null while still open), visitor_class, p_person, the page, referrer, user agent, and duration. Same filters as agent_detection_get_analytics plus a free-text search. per_page max 100.

Get one website visit and the evidence behind its verdict: the feature vector it was decided from, plain-language observations, and each model read. When the visit was recorded, the raw event stream is available; it is omitted unless include_events is true, and then capped at the first 200 events. The verdict is advisory: it comes from browser signals, which a determined attacker can fake.