{
  "info": {
    "name": "Brainiall Specialist AI APIs",
    "description": "Production-ready AI APIs for regulated workloads. 5 specialty SKUs (Background Removal, Audio Enhancement, Speaker Diarization, PDF-to-Markdown, Agent Memory) plus the Speech AI / NLP Suite / Image Processing endpoints.\n\nGet a free API key at https://app.brainiall.com — 100 images / 10 minutes / 10k events per month, forever free.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_postman_id": "b1234567-89ab-cdef-0123-456789abcdef"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      { "key": "token", "value": "{{BRAINIALL_API_KEY}}", "type": "string" }
    ]
  },
  "variable": [
    { "key": "BASE_URL", "value": "https://api.brainiall.com", "type": "string" },
    { "key": "BRAINIALL_API_KEY", "value": "brnl-...", "type": "string", "description": "Get a free key at https://app.brainiall.com" }
  ],
  "item": [
    {
      "name": "S1 — Background Removal",
      "description": "Drop-in replacement for Azure Image Analysis 4.0. Two tiers: Fast (rembg) or HD (BiRefNet, mIoU 0.95).",
      "item": [
        {
          "name": "Remove background (HD)",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/image/remove-background/base64", "host": ["{{BASE_URL}}"], "path": ["v1", "image", "remove-background", "base64"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"image\": \"<base64-encoded PNG/JPEG>\",\n  \"tier\": \"hd\",\n  \"output_format\": \"png\"\n}"
            },
            "description": "Returns transparent PNG. Use tier=fast (~0.4s) or tier=hd (BiRefNet, ~2s). Pricing: $0.002 fast / $0.02 hd per image."
          }
        }
      ]
    },
    {
      "name": "S2 — Audio Enhancement",
      "description": "Denoise + Voice Isolation + Cleanup + Master in one API. DeepFilterNet 3 + Demucs htdemucs + Whisper + pyloudnorm.",
      "item": [
        {
          "name": "Denoise (DeepFilterNet 3)",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/audio/enhance/denoise", "host": ["{{BASE_URL}}"], "path": ["v1", "audio", "enhance", "denoise"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"audio\": \"<base64-encoded WAV/MP3/OGG>\",\n  \"output_format\": \"wav\"\n}"
            },
            "description": "Real-time denoise. Removes hiss, rumble, ambient noise. Pricing: $0.005/minute."
          }
        },
        {
          "name": "Voice Isolation (Demucs)",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/audio/enhance/voice-isolation", "host": ["{{BASE_URL}}"], "path": ["v1", "audio", "enhance", "voice-isolation"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"audio\": \"<base64>\"\n}" }
          }
        },
        {
          "name": "Filler Cleanup (Whisper)",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/audio/enhance/cleanup", "host": ["{{BASE_URL}}"], "path": ["v1", "audio", "enhance", "cleanup"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"audio\": \"<base64>\"\n}" }
          }
        },
        {
          "name": "Master to -14 LUFS",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/audio/enhance/master", "host": ["{{BASE_URL}}"], "path": ["v1", "audio", "enhance", "master"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"audio\": \"<base64>\",\n  \"target_lufs\": -14\n}" }
          }
        }
      ]
    },
    {
      "name": "S3 — Speaker Diarization",
      "description": "pyannote 3.1 standalone. Returns turns with speaker label + start/end timestamps. 12% DER on AMI.",
      "item": [
        {
          "name": "Diarize",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/audio/diarize/base64", "host": ["{{BASE_URL}}"], "path": ["v1", "audio", "diarize", "base64"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"audio\": \"<base64-encoded WAV>\",\n  \"min_speakers\": 2,\n  \"max_speakers\": 5\n}"
            },
            "description": "Returns {turns: [{speaker, start, end, duration}], num_speakers_detected, num_turns}. Pricing: $0.01/minute."
          }
        }
      ]
    },
    {
      "name": "S4 — PDF-to-Markdown",
      "description": "Marker engine. Preserves headings, tables (markdown grid), inline LaTeX equations, multi-column layouts.",
      "item": [
        {
          "name": "Convert PDF to Markdown",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/document/pdf-to-markdown/base64", "host": ["{{BASE_URL}}"], "path": ["v1", "document", "pdf-to-markdown", "base64"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"pdf\": \"<base64-encoded PDF>\",\n  \"tier\": \"fast\"\n}"
            },
            "description": "Returns raw text/markdown body (Content-Type: text/markdown; charset=utf-8). Pricing: $0.001/page."
          }
        }
      ]
    },
    {
      "name": "S5 — Agent Memory",
      "description": "Multi-tenant semantic memory for AI agents. BGE-small embeddings. 1/5th the cost of Mem0.",
      "item": [
        {
          "name": "Add fact to namespace",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/memory/user-001/add", "host": ["{{BASE_URL}}"], "path": ["v1", "memory", "user-001", "add"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"text\": \"User prefers dark mode interfaces on desktop\",\n  \"metadata\": {\"category\": \"ui-prefs\"}\n}"
            },
            "description": "Adds an event/fact to the per-tenant namespace. Pricing: $0.00005/event."
          }
        },
        {
          "name": "Search namespace",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{BASE_URL}}/v1/memory/user-001/search?q=communication+style&k=5",
              "host": ["{{BASE_URL}}"],
              "path": ["v1", "memory", "user-001", "search"],
              "query": [
                { "key": "q", "value": "communication style" },
                { "key": "k", "value": "5" }
              ]
            },
            "description": "Top-k semantic search. p50 31ms, Recall@5 95%."
          }
        }
      ]
    },
    {
      "name": "Speech AI — Pronunciation / STT / TTS / Whisper",
      "item": [
        {
          "name": "Pronunciation Assessment",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/pronunciation/assess/base64", "host": ["{{BASE_URL}}"], "path": ["v1", "pronunciation", "assess", "base64"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"audio_base64\": \"<base64>\",\n  \"text\": \"Hello world\",\n  \"language\": \"en-US\"\n}" }
          }
        },
        {
          "name": "STT — Speech to Text",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/stt/transcribe/base64", "host": ["{{BASE_URL}}"], "path": ["v1", "stt", "transcribe", "base64"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"audio_base64\": \"<base64>\",\n  \"language\": \"en\"\n}" }
          }
        },
        {
          "name": "TTS — Text to Speech",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/tts/synthesize/base64", "host": ["{{BASE_URL}}"], "path": ["v1", "tts", "synthesize", "base64"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"text\": \"Welcome to Brainiall\",\n  \"voice\": \"af_heart\"\n}" }
          }
        },
        {
          "name": "Whisper STT Pro (99 languages)",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/whisper/transcribe/base64", "host": ["{{BASE_URL}}"], "path": ["v1", "whisper", "transcribe", "base64"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"audio_base64\": \"<base64>\",\n  \"language\": null,\n  \"diarize\": false\n}" }
          }
        }
      ]
    },
    {
      "name": "NLP Suite — Toxicity / Sentiment / Entities / PII / Language",
      "item": [
        {
          "name": "Toxicity Detection",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/nlp/toxicity", "host": ["{{BASE_URL}}"], "path": ["v1", "nlp", "toxicity"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"text\": \"This product is absolutely amazing\"\n}" }
          }
        },
        {
          "name": "Sentiment",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/nlp/sentiment", "host": ["{{BASE_URL}}"], "path": ["v1", "nlp", "sentiment"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"text\": \"I had a great experience\"\n}" }
          }
        },
        {
          "name": "Named Entities",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/nlp/entities", "host": ["{{BASE_URL}}"], "path": ["v1", "nlp", "entities"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"text\": \"Apple was founded by Steve Jobs in California\"\n}" }
          }
        },
        {
          "name": "PII Detection",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/nlp/pii", "host": ["{{BASE_URL}}"], "path": ["v1", "nlp", "pii"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"text\": \"Contact me at john@example.com or 555-1234\"\n}" }
          }
        },
        {
          "name": "Language Detection",
          "request": {
            "method": "POST",
            "url": { "raw": "{{BASE_URL}}/v1/nlp/language", "host": ["{{BASE_URL}}"], "path": ["v1", "nlp", "language"] },
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"text\": \"Bonjour, comment allez-vous?\"\n}" }
          }
        }
      ]
    }
  ]
}