# Introduction

Welcome to the documentation for BitMind, the AI content detection platform.

## Documentation

### [BitMind Overview](/bitmind-overview)

Learn about BitMind's mission, core technology, and ecosystem components.

### [Architecture Summary](/architecture-summary)

System architecture, components, and how they work together.

### [Getting Started](/getting-started)

Choose your path: consumer, developer, or enterprise.

### [API Reference](broken://pages/QQkwKUshcvwyvjlYQ29e)

Complete API documentation for all BitMind services and endpoints.

### [API Pricing](/pricing)

Plans, pricing, and feature comparison.

## Quick Start

### For Developers

* Start with [BitMind Overview](/bitmind-overview) to understand the platform
* Review [Architecture Summary](/architecture-summary) for system design
* Use [API Reference](broken://pages/QQkwKUshcvwyvjlYQ29e) for integration

### For Miners & Validators

* Visit [bitmind-subnet repository](https://github.com/BitMind-AI/bitmind-subnet) for mining guides
* Check [Mining Guide](https://github.com/BitMind-AI/bitmind-subnet/blob/main/docs/Mining.md)
* Review [Validator Guide](https://github.com/BitMind-AI/bitmind-subnet/blob/main/docs/Validating.md)

## Resources

* **Live Platform**: [app.bitmind.ai](https://app.bitmind.ai)
* **Main Website**: [bitmind.ai](https://bitmind.ai)
* **Chrome Extension**: [Chrome Web Store](https://chromewebstore.google.com/detail/ai-detector-bitmind/ejlhmbdnjjlifeeelpnlkkechnmojnhg)
* **Mobile Apps**: [iOS App Store](https://apps.apple.com/us/app/ai-or-not-ai-detection/id6742792714) | [Google Play Store](https://play.google.com/store/apps/details?id=ai.bitmind.game)
* **GitHub**: [github.com/BitMind-AI](https://github.com/BitMind-AI)

## Support

* **Email**: <hello@bitmind.ai>
* **Discord**: [discord.gg/bitmind](https://discord.gg/bitmind)

***

**© 2026 BitMind. All rights reserved.**


# BitMind Overview

## What is BitMind?

BitMind is an AI content detection platform that specializes in detecting AI-generated and synthetic media. Our platform provides a dynamic, self-evolving detection system that adapts to new threats, capable of identifying both synthetic and semi-synthetic media with high accuracy, regardless of content or the model that generated it.

## Core Mission

The explosive growth of generative AI technology has unleashed an unprecedented wave of synthetic media creation. AI-generated audiovisual content has become remarkably sophisticated, often indistinguishable from authentic media. This development presents a critical challenge to information integrity and societal trust in the digital age.

> #### 🎯 **OUR MISSION**
>
> ### **The most authoritative AI fraud detection by building a dynamic, self-evolving service that instantly adapts to new threats.**
>
> *Building the future of trustworthy content verification, one detection at a time.*

## Platform Overview

BitMind consists of several interconnected components:

* **AI Infrastructure**: Decentralized AI (DeAI) detection network on Bittensor Subnet 34
* **Infrastructure Layer**: Core platform services, APIs, and backend systems
* **Consumer Applications**: Mobile apps, browser extension, and web platform for end users
* **Enterprise Services**: Zero-retention API for business customers
* **Admin Platform**: Developer dashboard and subnet management tools

For detailed information about the system architecture, see our [Architecture Summary](/architecture-summary).

## Use Cases

### Finance & Banking

Protect against deepfake content in financial communications and documentation.

* **Content Verification**: Detect AI-generated images and videos in financial documents
* **Communication Security**: Verify authenticity of video content in financial communications
* **Document Authentication**: Identify synthetic media in transaction-related content

### Social Media

User-friendly deepfake detection for everyday consumers and content creators.

* **Browser Extension**: Real-time detection while browsing
* **Mobile App**: On-the-go content verification
* **Social Media Verification**: Protect against celebrity impersonation
* **Content Creator Tools**: Verify authenticity of user-generated content

### Government

Detect AI-generated content in government communications and public information.

* **Content Screening**: Identify AI-generated images and videos in official communications
* **Information Verification**: Screen public-facing content for synthetic media
* **Document Analysis**: Detect AI-generated elements in government documents

### Technology

Developer platforms and AI teams integrating detection via API.

* **Real-time Detection**: Sub-second API response for images
* **API Integration**: RESTful APIs for any application
* **C2PA Support**: Content credential extraction and verification

## Getting Started

### For End Users

1. **Web Platform**: Visit [bitmind.ai](https://bitmind.ai/)
2. **Mobile Apps**: Download from [iOS App Store](https://apps.apple.com/app/id6742792714) or [Google Play](https://play.google.com/store/apps/details?id=ai.bitmind.game)
3. **Browser Extension**: Install from Chrome Web Store
4. **API Access**: Sign up at [app.bitmind.ai](https://app.bitmind.ai/)

### For Developers

1. **API Documentation**: Review [API Reference](broken://pages/QQkwKUshcvwyvjlYQ29e)
2. **Get Started**: See [Getting Started](/getting-started)

### For Miners & Validators

1. **Mining Guide**: [bitmind-subnet/docs/Mining.md](https://github.com/BitMind-AI/bitmind-subnet/blob/main/docs/Mining.md)
2. **Validator Guide**: [bitmind-subnet/docs/Validating.md](https://github.com/BitMind-AI/bitmind-subnet/blob/main/docs/Validating.md)
3. **Incentive Mechanism**: [bitmind-subnet/docs/Incentive.md](https://github.com/BitMind-AI/bitmind-subnet/blob/main/docs/Incentive.md)

## Community & Support

### Resources

* **Documentation**: This comprehensive guide
* **GitHub**: [github.com/BitMind-AI](https://github.com/BitMind-AI)
* **Discord**: Community support and discussions
* **X (Twitter)**: [@bitmind](https://x.com/bitmind)

### Support Channels

* **Technical Support**: Available for all users
* **Enterprise Support**: Priority support for enterprise customers
* **Community Support**: Discord and GitHub discussions
* **Sales**: Contact for enterprise solutions at <hello@bitmind.ai>

***

**BitMind is building the future of trustworthy AI content detection, one detection at a time.**


# Architecture Summary

## Overview

BitMind operates as a distributed AI content detection platform with multiple interconnected components working together to provide accurate, scalable, and privacy-compliant deepfake detection services.

## Architecture

### Architecture Flow

The BitMind platform operates through five interconnected layers:

1. **User Layer**: Multi-platform interfaces (web, mobile, browser extension, enterprise clients) provide seamless access
2. **API Gateway**: Routes requests through specialized endpoints for platform, subnet, and enterprise operations
3. **Infrastructure**: Leverages Modal for ML inference, Supabase for data management, and Cloudflare for global distribution
4. **Bittensor Network**: Powers decentralized AI with Subnet 34 for fraud detection, distributed miners, and validator nodes
5. **Storage Layer**: Manages models and datasets across R2, Modal Volumes, and HuggingFace repositories

## Core Components

### 1. AI Infrastructure (Bittensor Subnet 34)

**Purpose**: Decentralized AI (DeAI) network that realizes a continuous, dynamic, incentivized competition for producing accurate detection models and novel, high-signal training data.

**Architecture**:

* **Detection Miners**: Submit packaged models (no live endpoints) for validator-side evaluation on curated benchmarks
* **Generation Miners**: Adversarially generate high-signal synthetic media that evolves the benchmark
* **Validators**: Evaluate submitted models locally, track benchmark versions, and distribute rewards based on measured performance
* **Adversarial Loop**: Generators push realism; discriminators improve detection — both co-evolve under aligned incentives
* **Model Management**: Automated submission, testing, and deployment flows

**Key Features**:

* Fully-generalized detection (works across different generative AI models)
* Continuous evolution with new generative AI
* Economic incentives for high-quality models
* Centralized evaluation inside validators improves privacy, determinism, and reproducibility
* Open, renewable training data via shared public corpus

### 2. Infrastructure Services

| Platform                                           | ML Inference                        | API Cloud Services                           |
| -------------------------------------------------- | ----------------------------------- | -------------------------------------------- |
| Admin at [app.bitmind.ai](https://app.bitmind.ai/) | High-performance ONNX inference     | Public API layer exposing endpoints to users |
| Developer dashboard and miner performance stats    | Cost-efficient model serving        | Image and video detection                    |
| API key management and usage analytics             | Smart GPU cache with auto-recovery  | Video preprocessing and segmentation         |
| Account administration and billing                 | Processing for efficiency           | C2PA integration for content provenance      |
| Integration with Bittensor ecosystem               | Security validation for ONNX models | High-throughput processing                   |

### 3. API Services

**Purpose**: Detection interfaces for consumer and enterprise workloads.

**Architecture**:

* **Subnet API** (`api.bitmind.ai`): Image and video detection with analytics, caching, and storage
* **Enterprise API** (`enterprise.bitmind.ai`): Same detection pipeline with zero data retention
* **Security**: API key auth, per-client rate limiting, Redis-backed quota tracking

**Key Features**:

* Zero data retention (enterprise)
* C2PA content credential extraction
* Similarity matching against known AI content
* Enterprise compliance (GDPR-ready)

### 4. Consumer Applications

**Purpose**: End-user experiences for fast, trustworthy deepfake detection.

**Architecture**:

* **Mobile (iOS/Android)**: Native apps for camera/gallery input
* **Web (bitmind.ai)**: Uploads, URL-based analysis, direct image address
* **Browser Extension**: On-page scanning and one-click verification across major sites

**Key Features**:

* Instant detection UX (mobile/web)
* URL/direct-address analysis (web)
* Privacy-first design (extension)
* Push notifications and usage insights (mobile)

## Architectural Highlights

### Detection Capabilities

* **Multi-Modal**: Images and videos
* **Real-Time**: Sub-second inference for images
* **Accuracy**: State-of-the-art detection performance
* **Adversarial Benchmarking**: Continuous refresh from generator submissions to surface new edge cases

### Privacy & Compliance

* **Zero Data Retention**: No input data stored (enterprise)
* **GDPR Compliant**: Zero data retention aligns with data minimization
* **SOC2**: Via Modal infrastructure ([details](https://modal.com/blog/soc2type2))
* **Reproducible Evaluation**: Results pinned to benchmark versions and model hashes

### Scalability

* **Horizontal Scaling**: Auto-scaling via Modal infrastructure
* **Global CDN**: Low-latency worldwide access via Cloudflare
* **Load Balancing**: High availability across regions


# Getting Started

Kick off with BitMind in minutes. Choose the path that fits you best:

## Quick links

| Path       | Best for                                | Next step                                                                                                                     |
| ---------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Consumers  | Individuals who want to verify content  | Use the web app at [bitmind.ai](https://bitmind.ai/)                                                                          |
| Developers | Teams integrating detection into apps   | Get an API key at [app.bitmind.ai](https://app.bitmind.ai/) and read the [API Reference](broken://pages/QQkwKUshcvwyvjlYQ29e) |
| Enterprise | Large orgs with compliance/custom needs | Email `hello@bitmind.ai` or [Contact BitMind](https://bitmind.ai/contact)                                                     |

***

## 1) Consumers: Use BitMind Apps and Extensions

* Use the web app at [bitmind.ai](https://bitmind.ai/)
* Download our mobile apps and browser extensions to detect AI-generated content as you browse
  * iOS (Apple App Store): [Download](https://apps.apple.com/app/id6742792714)
  * Android (Google Play): [Download](https://play.google.com/store/apps/details?id=ai.bitmind.game)
* Sign in to sync usage across devices and view your detection history

| Feature            | Web | Mobile | Extension |
| ------------------ | --- | ------ | --------- |
| Image detection    | Yes | Yes    | Yes       |
| Video detection    | Yes | Yes    | Yes       |
| Social integration | —   | Yes    | Yes       |
| Real-time overlay  | —   | —      | Yes       |

***

## 2) Developers: Get an API Key and Build

1. Create an account at [app.bitmind.ai](https://app.bitmind.ai/)
2. Generate an API key
3. Start integrating with our endpoints — see the [API Reference](broken://pages/QQkwKUshcvwyvjlYQ29e)

**Base URL:** `https://api.bitmind.ai`

Example — image detection:

```bash
curl -X POST https://api.bitmind.ai/detect-image \
  -H "Authorization: Bearer $BITMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://example.com/image.jpg"}'
```

Tips:

* Store your API key securely and never commit it to version control
* Use `debug: true` in your request body for additional diagnostic fields

***

## 3) Enterprise: Talk to Sales

* Email: `hello@bitmind.ai`
* Or contact us via the form on our website: [Contact BitMind](https://bitmind.ai/contact)

| Capability            | Description                                         |
| --------------------- | --------------------------------------------------- |
| Custom SLAs           | Dedicated support with guaranteed response times    |
| On-prem/cloud options | Deploy to your environment or use our managed cloud |
| Compliance            | SOC 2 via Modal infrastructure                      |
| Zero data retention   | In-memory processing, no data stored                |

***

## Pricing

See plans and FAQs on the [Pricing](/pricing) page.


# API Pricing

Start free, scale confidently, and ship faster with best-in-class detection at a price that fits your growth.

## Plans Overview

Choose a plan that matches your stage. Upgrade anytime.

| Plan             | Price   | Best for                                                       |
| ---------------- | ------- | -------------------------------------------------------------- |
| Free             | $0/mo   | Trying the API and demos with up to 100 requests/month         |
| Pro              | $100/mo | Teams and power users who need 10,000+ requests/month          |
| Custom Solutions | Custom  | Large organizations with bespoke needs, SLAs, and integrations |

Quick links: [Feature Comparison](#feature-comparison) · [Throughput](#throughput) · [FAQ](#frequently-asked-questions) · [Contact](#contact)

***

## Feature Comparison

| Feature             |    Free   |   Pro   |      Custom Solutions      |
| ------------------- | :-------: | :-----: | :------------------------: |
| Price (USD/mo)      |     $0    |   $100  |           Custom           |
| Requests/month      |    100    | 10,000+ | Unlimited / contract-based |
| Email support       | Community |    ✓    |        ✓ (priority)        |
| 24/7 support        |     —     |    —    |       ✓ (as per SLA)       |
| SDKs & examples     |     ✓     |    ✓    |              ✓             |
| Usage analytics     |     ✓     |    ✓    |              ✓             |
| Rate limit upgrades |     —     |    ✓    |              ✓             |
| On‑premise          |     —     |    —    |              ✓             |
| Custom SLAs         |     —     |    —    |              ✓             |
| Dedicated manager   |     —     |    —    |              ✓             |
| Custom integrations |     —     | Limited |              ✓             |

***

## Throughput

Each plan includes base throughput suitable for typical workloads. You may exceed these limits temporarily based on elastic capacity; implement retries for best results.

| Plan             | Base throughput (req/sec) |
| ---------------- | ------------------------: |
| Free             |                         1 |
| Pro              |                       10+ |
| Custom Solutions |   Custom / contract-based |

Note: Throughput, SLAs, and deployment models for Custom Solutions are customized during onboarding.

***

## Frequently Asked Questions

### Getting Started

**How quickly can we get started?**

Most implementations can begin within 1–2 weeks. Enterprise customers with custom requirements may take 2–4 weeks for full deployment.

**What are your pricing options?**

We offer a Free plan (100 requests/month), a Pro plan at $100/month with 10,000+ requests/month, and Custom Solutions for large-scale and enterprise deployments.

**Do you offer a free trial?**

Yes, we provide a free tier for developers and a trial period for enterprise customers. Contact our sales team to discuss your specific needs.

### Technical Support

**What kind of support do you provide?**

We offer priority support for enterprise customers, comprehensive documentation, and dedicated account managers for large implementations.

**What APIs do you support?**

We provide REST APIs for image and video detection. See the [API Reference](broken://pages/QQkwKUshcvwyvjlYQ29e).

### Enterprise

**Do you offer on-premise deployment?**

Yes, we support both cloud and on-premise deployments to meet your security and compliance requirements.

**What compliance standards do you meet?**

Our infrastructure runs on Modal, which maintains SOC 2 compliance. Our enterprise API is designed with zero data retention, aligning with GDPR data minimization principles.

**Can you integrate with our existing systems?**

Yes. Our APIs are designed for easy integration with existing workflows, security systems, and content management platforms.

### Product Features

**What types of content can you detect?**

We detect AI-generated images and videos.

**Do you support real-time detection?**

Yes, our API provides real-time detection with sub-second latency for image analysis.

***

Still have questions? Our team is here to help. [Contact support](https://bitmind.ai/contact).

***

## Contact

For enterprise pricing and custom solutions: `hello@bitmind.ai` or [Contact BitMind](https://bitmind.ai/contact).


# API Reference

## Overview

BitMind provides two detection APIs built for different workloads.

Use the standard API for general image and video detection integrations.

Use the Enterprise API for the same core detection pipeline with zero data retention.

Use the sidebar categories for endpoint details.

## Reference Pages

* [Authentication](/api-reference/authentication)

### API

Base URL: `https://api.bitmind.ai`

### Enterprise API

Base URL: `https://enterprise.bitmind.ai`

## Specs

* [Subnet API spec](https://github.com/BitMind-AI/docs/blob/main/api-specs/subnet-api/subnet-api-openapi.yaml)
* [Enterprise API spec](https://github.com/BitMind-AI/docs/blob/main/api-specs/enterprise-api/enterprise-api-openapi.yaml)

## Notes

* Enterprise endpoints require enterprise credentials.
* Enterprise video access must be enabled on your account.
* For help, see [Support](/support).


# Authentication

Authentication methods and rate limits for BitMind APIs.

BitMind APIs use the same HTTP Bearer authentication format.

```http
Authorization: Bearer <YOUR_API_KEY>
```

## What changes between APIs

The header format is identical.

The accepted key type is different.

### API

`https://api.bitmind.ai`

Accepts standard API keys for normal platform usage.

These are typically universal service keys.

### Enterprise API

`https://enterprise.bitmind.ai`

Requires an enterprise API key.

These keys are enterprise-tier credentials.

Standard API keys are rejected with `401 Unauthorized`.

## API key authentication

Use API keys for server-to-server requests.

### Standard API example

```http
Authorization: Bearer your-api-key
```

### Enterprise API example

```http
Authorization: Bearer enterprise-your-key
```

## JWT authentication

Use JWTs for user-facing applications where supported.

```http
Authorization: Bearer your-jwt-token
```

## Headers

Some applications also send an application identifier header.

```http
x-bitmind-application: oracle-api
```

## Rate limits

* **API key users**: Based on subscription tier
* **JWT users**: `1` request/second with burst up to `5`

## Best practices

* Store tokens in environment variables or a secret manager.
* Never commit tokens to source control.
* Rotate long-lived credentials regularly.
* Use enterprise keys only against enterprise endpoints.


# API

Use the standard BitMind API for general integrations.

Base URL: `https://api.bitmind.ai`

This surface is intended for normal application and backend usage. Use it when you need standard detection access with regular API keys.

## Choosing an endpoint

Most integrations should start with [**Unified Detect**](/api-reference/api/v1-detect) (`POST /v1/detect`). It inspects your input, figures out whether it's an image, video, or text, and runs the right detector — so you don't have to branch on media type yourself.

Call a **type-specific endpoint** when you already know the media type and want to be explicit:

| Endpoint                                        | Use when                                                             |
| ----------------------------------------------- | -------------------------------------------------------------------- |
| [Unified Detect](/api-reference/api/v1-detect)  | You want one endpoint to auto-detect and route (recommended default) |
| [Detect Image](/api-reference/api/detect-image) | The input is always an image                                         |
| [Detect Video](/api-reference/api/detect-video) | The input is always a video (and you may want trim parameters)       |
| [Detect Text](/api-reference/api/detect-text)   | The input is always text                                             |

All of these return the same per-type result shapes; Unified Detect simply wraps the matching result in a `{ "mediaType", "result" }` envelope.


# Unified Detect

One endpoint that auto-detects the media type and routes detection.

A single endpoint that inspects your input, determines whether it's an **image**, **video**, or **text**, and runs the right detector — so you don't have to call a type-specific endpoint. This is the recommended front door for new integrations.

## Endpoint

`POST https://api.bitmind.ai/v1/detect`

## Authentication

Send a Bearer token in the `Authorization` header.

See [Authentication](/api-reference/authentication).

## How routing works

The media type is resolved automatically:

* **Binary uploads** (file, base64, or a downloaded URL) are identified by their content — JPEG/PNG/etc. → image, MP4/WebM/etc. → video.
* **Plain text** is detected implicitly — no flag required. A `text/plain` body, a JSON `text` field, or a JSON `media` string that isn't a URL/base64 medium is scored as text.
* Bytes that match no supported media format are rejected with `415`.

You may optionally set `type` to force routing (`image`, `video`, or `text`). A `type` that contradicts the actual bytes returns `400`.

## Request

### Auto-detected URL

```bash
curl -X POST https://api.bitmind.ai/v1/detect \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"media": "https://example.com/photo.jpg"}'
```

### Multipart file upload

```bash
curl -X POST https://api.bitmind.ai/v1/detect \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@clip.mp4"
```

### Plain text (implicit)

```bash
curl -X POST https://api.bitmind.ai/v1/detect \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: text/plain" \
  --data "In conclusion, the synergistic leveraging of cross-functional..."
```

### JSON fields

| Field         | Type    | Required | Description                                                          |
| ------------- | ------- | -------- | -------------------------------------------------------------------- |
| `media`       | string  | No\*     | URL or base64 data URI of an image/video                             |
| `text`        | string  | No\*     | Text passage to analyze (alternative to `media`)                     |
| `type`        | string  | No       | Force routing: `image`, `video`, or `text` (otherwise auto-detected) |
| `debug`       | boolean | No       | Include debug data in the response                                   |
| `postContext` | object  | No       | Source context, forwarded to text detection                          |

\* Provide exactly one of `media`, `text`, or a multipart `file`.

For **video**, the trim parameters `startTime`, `endTime`, and `fps` are honored, just like [Detect Video](/api-reference/api/detect-video).

## Response

The response is an envelope: `mediaType` tells you what was detected, and `result` is the **same payload** the type-specific endpoint returns.

```json
{
  "mediaType": "image",
  "result": {
    "isAI": false,
    "confidence": 0.23,
    "similarity": 0.05,
    "objectKey": "1234567890.jpg"
  }
}
```

| Field       | Type   | Description                                |
| ----------- | ------ | ------------------------------------------ |
| `mediaType` | string | Detected type: `image`, `video`, or `text` |
| `result`    | object | The native detection result for that type  |

See [Detect Image](/api-reference/api/detect-image), [Detect Video](/api-reference/api/detect-video), and [Detect Text](/api-reference/api/detect-text) for the per-type `result` shapes.


# Detect Image

Detect AI-generated images.

Detect if an image is AI-generated.

## Endpoint

`POST https://api.bitmind.ai/detect-image`

## Authentication

Send a Bearer token in the `Authorization` header.

See [Authentication](/api-reference/authentication).

## Request

```bash
curl -X POST https://api.bitmind.ai/detect-image \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://example.com/photo.jpg"}'
```

### Multipart upload

```bash
curl -X POST https://api.bitmind.ai/detect-image \
  -H "Authorization: Bearer $API_KEY" \
  -F "image=@photo.jpg"
```

### JSON fields

| Field   | Type    | Required | Description                        |
| ------- | ------- | -------- | ---------------------------------- |
| `image` | string  | Yes      | Image URL or base64 data URI       |
| `debug` | boolean | No       | Include debug data in the response |

### Multipart fields

| Field   | Type   | Required | Description           |
| ------- | ------ | -------- | --------------------- |
| `image` | file   | Yes      | Image file to upload  |
| `debug` | string | No       | `"true"` or `"false"` |

### Supported formats

`JPEG`, `PNG`, `GIF`, `BMP`, `WebP`, `AVIF`

## Response

```json
{
  "isAI": false,
  "confidence": 0.23,
  "similarity": 0.05,
  "objectKey": "1234567890.jpg"
}
```

### Response with debug enabled

```json
{
  "isAI": false,
  "confidence": 0.23,
  "similarity": 0.05,
  "objectKey": "1234567890.jpg",
  "debug": {
    "raw": 0.42,
    "processingTime": 1.2,
    "region": "us",
    "contentCredentials": {
      "hasCredentials": false
    }
  }
}
```


# Detect Video

Detect AI-generated videos.

Detect if a video is AI-generated.

## Endpoint

`POST https://api.bitmind.ai/detect-video`

## Authentication

Send a Bearer token in the `Authorization` header.

See [Authentication](/api-reference/authentication).

## Request

```bash
curl -X POST https://api.bitmind.ai/detect-video \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video": "https://example.com/video.mp4"}'
```

### Multipart upload

```bash
curl -X POST https://api.bitmind.ai/detect-video \
  -H "Authorization: Bearer $API_KEY" \
  -F "video=@video.mp4"
```

### JSON fields

| Field       | Type    | Required | Description                                                    |
| ----------- | ------- | -------- | -------------------------------------------------------------- |
| `video`     | string  | Yes      | Video URL. Supports YouTube, Twitter, TikTok, and direct links |
| `startTime` | float   | No       | Start time in seconds                                          |
| `endTime`   | float   | No       | End time in seconds                                            |
| `fps`       | integer | No       | Frames per second for analysis                                 |
| `debug`     | boolean | No       | Include debug data in the response                             |

### Multipart fields

| Field       | Type   | Required | Description                    |
| ----------- | ------ | -------- | ------------------------------ |
| `video`     | file   | Yes      | Video file to upload           |
| `startTime` | string | No       | Start time in seconds          |
| `endTime`   | string | No       | End time in seconds            |
| `fps`       | string | No       | Frames per second for analysis |
| `debug`     | string | No       | `"true"` or `"false"`          |

## Response

```json
{
  "isAI": true,
  "confidence": 0.87,
  "similarity": 0.0,
  "objectKey": "1234567890.mp4",
  "thumbnailObjectKey": "thumbnails/1234567890/main.jpg"
}
```

## Notes

* Direct uploads are limited to `10MB`
* For larger files, use the presigned upload flow in [API Reference](/api-reference)


# Detect Text

Detect AI-generated text.

Detect if a passage of text is AI-generated.

## Endpoint

`POST https://api.bitmind.ai/detect-text`

## Authentication

Send a Bearer token in the `Authorization` header.

See [Authentication](/api-reference/authentication).

## Request

```bash
curl -X POST https://api.bitmind.ai/detect-text \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "In conclusion, the synergistic leveraging of cross-functional..."}'
```

### JSON fields

| Field         | Type    | Required | Description                                             |
| ------------- | ------- | -------- | ------------------------------------------------------- |
| `text`        | string  | Yes      | The text passage to analyze                             |
| `debug`       | boolean | No       | Include debug data (raw score, processing time, region) |
| `postContext` | object  | No       | Optional source context (platform, source URL, author)  |

### Requirements

Provide at least **200 characters** of text. Shorter passages are rejected with `400` — there isn't enough signal to score reliably. English-language text scores best; unsupported languages or provider issues degrade gracefully to `verdict: "uncertain"`.

## Response

```json
{
  "isAI": true,
  "confidence": 0.91,
  "verdict": "ai"
}
```

| Field        | Type    | Description                                                             |
| ------------ | ------- | ----------------------------------------------------------------------- |
| `isAI`       | boolean | Whether the text is detected as AI-generated                            |
| `confidence` | number  | Confidence score (0.0–1.0, higher = more confident)                     |
| `verdict`    | string  | Tri-state: `ai`, `human`, or `uncertain` (low-confidence / unavailable) |

### Response with debug enabled

```json
{
  "isAI": true,
  "confidence": 0.91,
  "verdict": "ai",
  "debug": {
    "raw": 0.91,
    "processingTime": 0.8,
    "region": "us"
  }
}
```


# Enterprise API

Use the Enterprise API for zero-retention integrations.

## Overview

This API is intended for enterprise customers.

It uses enterprise-scoped credentials.

It does not store submitted media.

It does not log analytics for processed media.

Base URL: `https://enterprise.bitmind.ai`

### Authentication

Send a Bearer token in the `Authorization` header.

Use an enterprise API key.

Standard API keys are rejected.

See [Authentication](/api-reference/authentication).

### Endpoints

#### `POST /image`

Zero-retention image detection.

See [Enterprise Image](/api-reference/enterprise-api/enterprise-image).

#### `POST /video`

Zero-retention video detection.

Video access must be enabled on your account.

See [Enterprise Video](/api-reference/enterprise-api/enterprise-video).

### Response shape

Enterprise endpoints return the same core detection fields.

They do not return storage keys because media is not retained.

```json
{
  "isAI": false,
  "confidence": 0.897
}
```

### Rate limits

Rate limits are configured per client.

Typical ranges are `1,000` to `10,000+` requests per hour.


# Enterprise Image

Zero-retention image detection for enterprise customers.

Detect AI-generated images with zero data retention.

## Endpoint

`POST https://enterprise.bitmind.ai/image`

## Authentication

Send a Bearer token in the `Authorization` header.

Use an enterprise API key.

Standard API keys are rejected.

See [Authentication](/api-reference/authentication).

## Availability

This endpoint is for enterprise customers.

Keys are provisioned by the BitMind team.

## Request

```bash
curl -X POST https://enterprise.bitmind.ai/image \
  -H "Authorization: Bearer $ENTERPRISE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://example.com/photo.jpg"}'
```

### JSON fields

| Field   | Type    | Required | Description                        |
| ------- | ------- | -------- | ---------------------------------- |
| `image` | string  | Yes      | Image URL or base64 data URI       |
| `debug` | boolean | No       | Include debug data in the response |

### Multipart fields

| Field   | Type   | Required | Description           |
| ------- | ------ | -------- | --------------------- |
| `image` | file   | Yes      | Image file to upload  |
| `debug` | string | No       | `"true"` or `"false"` |

## Response

```json
{
  "isAI": false,
  "confidence": 0.897
}
```

## Notes

* Uses the enterprise zero-retention pipeline.
* No media is stored.
* No analytics are logged.


# Enterprise Video

Zero-retention video detection for enterprise customers.

Detect AI-generated videos with zero data retention.

## Endpoint

`POST https://enterprise.bitmind.ai/video`

## Authentication

Send a Bearer token in the `Authorization` header.

Use an enterprise API key.

Standard API keys are rejected.

See [Authentication](/api-reference/authentication).

## Availability

This endpoint is for enterprise customers.

Video detection must be enabled for your enterprise account.

## Request

```bash
curl -X POST https://enterprise.bitmind.ai/video \
  -H "Authorization: Bearer $ENTERPRISE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video": "https://example.com/video.mp4"}'
```

### JSON fields

| Field       | Type    | Required | Description                            |
| ----------- | ------- | -------- | -------------------------------------- |
| `video`     | string  | Yes      | Video URL or direct uploaded media URL |
| `startTime` | float   | No       | Start time in seconds                  |
| `endTime`   | float   | No       | End time in seconds                    |
| `fps`       | integer | No       | Frames per second for analysis         |
| `debug`     | boolean | No       | Include debug data in the response     |

### Multipart fields

| Field       | Type   | Required | Description                    |
| ----------- | ------ | -------- | ------------------------------ |
| `video`     | file   | Yes      | Video file to upload           |
| `startTime` | string | No       | Start time in seconds          |
| `endTime`   | string | No       | End time in seconds            |
| `fps`       | string | No       | Frames per second for analysis |
| `debug`     | string | No       | `"true"` or `"false"`          |

## Response

```json
{
  "isAI": true,
  "confidence": 0.917
}
```

## Notes

* Uses the enterprise zero-retention pipeline.
* No media is stored.
* Video access is account-scoped.


# Support

Need help? We’re here.

* Email: <hello@bitmind.ai>
* Contact form: [bitmind.ai/contact](https://bitmind.ai/contact)

Community:

* Discord: [Join our community](https://discord.gg/bitmind)
* X (Twitter): [@bitmind](https://x.com/bitmind)

For enterprise inquiries, include your organization name, use case, and expected volumes.