Skip to main content
Neural Defend

How to Switch From Reality Defender to Neural Defend

To switch from Reality Defender to Neural Defend, inventory every call to Reality Defender, map its submit-then-retrieve flow onto NeuroVerify's synchronous response, run both APIs on the same genuine and attack samples, shadow live traffic for two to four weeks, then cut over one flow at a time with rollback ready. The code change is small; NeuroVerify integration takes two lines and can be live in under 24 hours.

Organization authorNeural Defend Editorial
Updated July 31, 2026
Piyush Verma, Co-founder and CEO of Neural Defend.
Piyush VermaCo-founder & CEO
Conceptual 3D render illustrating How to Switch From Reality Defender to Neural Defend

Before you start: decide what you are replacing

List every place Reality Defender runs today and what each result controls. A typical estate includes onboarding selfie checks, recovery or re-verification video, uploaded-file screening by an investigations team, and sometimes call or meeting monitoring. Neural Defend maps these to NeuroVerify for identity checks on face images, video and audio, NeuroDetect for forensic review, and NeuroCall, in Beta, for voice calls. Neural Defend's meeting product is not yet available, so keep Reality Defender in place for live meeting monitoring if you depend on it.

For each flow, record the media types and sizes, current thresholds, decision owner, daily volume and the false-positive rate you see now. Those numbers become the acceptance criteria for the new vendor. Note any videos above 250 MB or 30 minutes that you currently split to fit Reality Defender's documented limits; NeuroVerify's video endpoint accepts up to 1.5 GB, so that splitting logic may become optional.

Light enterprise still life for switching from reality defender to neural defend: how-related verification objects on a white surface, no people.

Step 1 and 2: inventory calls and map the integration

Reality Defender's documentation describes a two-stage pattern: submit a file or URL through an SDK, receive a requestId, then retrieve the analysis by event or polling. NeuroVerify's image endpoint (POST /detect/image) and video endpoint (POST /detect/video) return the result in the response body. In practice, the polling worker or event handler you built for Reality Defender can often be removed for selfies, while long video may still run from a background job so the user is not holding a connection.

Swap the SDK at an adapter boundary rather than throughout the codebase. Both vendors offer Python, TypeScript, Go and Java SDKs, so most teams keep the same language. NeuroVerify adds Android/Kotlin, iOS/Swift and Flutter SDKs for capture apps and an MCP server for AI agents. Store the NeuroVerify API key in a secret manager and keep it server-side.

ConceptReality Defender (documented)NeuroVerify (documented)What to change
SubmissionSDK upload of a file or social media URLMultipart POST to /detect/image or /detect/video, or an SDK methodReplace the upload call inside your adapter
Result retrievalrequestId, then event-based or polling retrievalResult returned in the responseRemove or simplify polling for short media
Outcome statesPer Reality Defender's result schemastatus: success, rejected or errorAdd explicit branches; null is never low risk
ScorePer Reality Defender's result schemarisk_score 0.1 to 10.0 and risk_level low, medium or high; video and audio scored separatelyRebuild rules on risk_level
Audit keyrequestIdunique_trx_idStore alongside your case ID
Video limits250 MB, 30 minutesUp to 1.5 GB; 12 sampled frames by default, 1 to 100Revisit splitting and sampling settings
Integration concepts to map when moving from Reality Defender to NeuroVerify. Based on each vendor's public documentation, checked 19 October 2026.

Step 3: run a side-by-side test on your own media

Build a test set from your own traffic: a few hundred genuine captures that reflect your real devices, lighting, compression and customer demographics, plus a matched set of attacks such as face swaps, fully generated faces, replays and, if you can produce them safely, injected streams. Send every sample to both APIs.

Score each vendor with MCC and specificity, not accuracy alone, because attack sets are usually smaller than genuine sets. Count false positives per 1,000 genuine sessions at the threshold you would actually ship, and record p95 latency from your own region. For context, the public VendorBench-100 benchmark (v2, July 2026) scored Neural Defend at MCC 0.876 and Reality Defender at 0.646 on 100 adversarial still images; one of its authors also co-authored Neural Defend's ARCAS 1B paper, and the results are public. Your own data should decide.

Keep the test honest. Label every sample before either vendor sees it, freeze the set once testing starts, and have someone other than the integration engineer review the disagreements. Look closely at cases where the two vendors disagree: those files show where each model is weak, and they make a good regression set for future model updates.

Steps 4 to 6: shadow traffic, staged cutover and rollback

Shadow live traffic before NeuroVerify makes any decision. Send each production request to both vendors, act only on Reality Defender, and log both results with the same case ID. Two to four weeks usually covers weekday and weekend patterns and a marketing peak or two.

Cut over one flow at a time, starting with the lowest-risk one. Keep Reality Defender credentials active and a feature flag ready so you can route back within minutes. Define rollback triggers in advance, for example false positives above an agreed rate per 1,000 genuine sessions, p95 latency above the screen's tolerance, or error rates above an agreed threshold.

  • Week 0: inventory, adapter and field mapping complete; staging credentials issued.
  • Weeks 1 to 2: side-by-side test on your labelled set; thresholds agreed with the decision owner.
  • Weeks 2 to 5: shadow traffic on every flow being migrated.
  • Weeks 5 onward: staged cutover by flow, with rollback triggers monitored daily.
  • After the last flow: decommission Reality Defender keys and archive its results under your retention policy.

Mistakes that cause trouble after cutover

The most common error is reading a missing score as a pass. NeuroVerify returns a rejected status, with no score, when an image has no face or several faces, and that can arrive on HTTP 200. Treat it as a retake or review case. The second is copying thresholds numerically from the old vendor; score scales differ, so derive new ones from the side-by-side test. The third is stacking retries. NeuroVerify's API is not idempotent, the official SDKs already retry selected 429, 500 and 503 responses, and they deliberately do not retry timeouts, because an outer loop can create duplicate billable transactions.

What you gain after the switch

Teams that finish the move get six signals in one call, including Live Presence Verification and Face Manipulation Detection, with one risk score and signal-level evidence. Neural Defend reports under 200 ms p95 on eligible image requests under defined test conditions. Deployment can move to private cloud, on-premises or air-gapped if your data rules tighten, and Neural Defend's ISO/IEC 27001, ISO/IEC 27701, ISO/IEC 42001 and SOC 2 Type II certifications support the vendor review. NeuroVerify does not analyse ID documents, so keep your document verification provider in the flow.

Evidence boundary

Limitations

  • Reality Defender details are limited to what its public SDK quickstart and homepage state on 19 October 2026; check its current result schema when mapping fields.
  • NeuroVerify details reflect Neural Defend's public developer documentation as of August 2026.
  • VendorBench-100 covers still images only; one of its authors co-authored Neural Defend's ARCAS 1B paper.
  • Neural Defend's meeting product is not yet available, so meeting monitoring cannot move in this migration.

Frequently asked questions

How long does it take to switch from Reality Defender to Neural Defend?

The integration can be live in under 24 hours, but a safe switch takes longer because of testing. Plan roughly one to two weeks for a side-by-side test on your own labelled media, two to four weeks of shadow traffic, then a staged cutover by flow. Change-control and model-risk review often set the real timeline.

Can I run Reality Defender and Neural Defend at the same time?

Yes, and you should during the migration. Send each request to both, act only on the incumbent, and log both results with the same case ID. That shadow period shows how decisions would change before any customer is affected, and it gives you the data to set NeuroVerify thresholds.

Do I need to change my thresholds when switching?

Yes. Score scales differ between vendors, so a numeric threshold copied across will not mean the same thing. NeuroVerify returns a risk_score from 0.1 to 10.0 and a risk_level of low, medium or high, and Neural Defend advises building rules on the band. Set thresholds from your side-by-side test results.

What if I use Reality Defender for meetings?

Keep it for meetings for now. Neural Defend's meeting product is not yet available, so a full switch is not possible for live meeting monitoring. Many teams move identity and onboarding checks to NeuroVerify and investigations to NeuroDetect first, and revisit meetings later.

Is there a migration checklist?

Yes. Neural Defend publishes a migration checklist and guides covering API and SDK migration, parallel-run proofs of concept, and post-migration monitoring and rollback. Use them alongside the six steps on this page, and agree rollback triggers with your decision owner before the first flow moves.

Source record

Sources and references

  1. Reality DefenderReality Defender SDK quickstartVerified October 19, 2026.
  2. Reality DefenderReality Defender deepfake detection platformVerified October 19, 2026.
  3. Neural DefendReading NeuroVerify API resultsVerified October 19, 2026.
  4. Neural DefendNeuroVerify developer quickstartVerified October 19, 2026.
  5. Neural DefendNeuroVerify errors and retriesVerified October 19, 2026.
  6. arXivVendorBench-100: A Unified Cross-Paradigm Benchmark for Deepfake Image DetectionPublished July 7, 2026. Verified October 19, 2026.

Plan the move

Plan your Reality Defender to NeuroVerify migration

Get staging credentials, run the side-by-side test on your own captures, and agree rollback triggers before the first flow moves.

Explore NeuroVerify