CNAPS Studio User Guides

CNAPS Studio User Guides

The complete guide to building AI-powered image, video, and audio workflows.

CNAPS Studio is a no-code AI platform for image, video, and audio work. Start on Home: pick a card, and a finished AI task runs for you — background removal, upscaling, poster generation, transcription, and more. When you want to change how a task works, open that same card on the canvas and rewire it yourself. This guide covers everything from your first card to batch processing.

Table of Contents

  1. What is CNAPS Studio?
  2. Home — Pick a Card, Get a Result
  3. Understanding the Basics
  4. Platform Guide
  5. Common Challenges & Solutions
  6. API Integration
  7. MCP Guide
  8. n8n Guide
  9. Zapier Guide
  10. Glossary
  11. Additional Resources

What is CNAPS Studio?

CNAPS Studio is a no-code AI platform for image, video, and audio work. There are two ways in: pick a ready-made card on Home and run it as it is, or build your own workflow on the canvas. On the canvas, think of it like LEGO blocks — snap together AI models and tools to automate tasks that would normally require expensive software or a technical team. No programming required either way.

Two ways to use it

Home 🃏
CNAPS Studio 🎨
Best for
Getting one task done right now
Custom multi-step workflows
How it works
Pick a card → swap the input → Run again
Drag, connect & configure nodes
Starting point
A finished example, already on screen
A blank canvas, or any card's flow
Skill needed
None
None (a little curiosity helps)
Works on mobile
Desktop recommended
image
image

Who It's For

Marketers 🎯
E-commerce Operations Managers 🩳
Security Teams 🗝️
Medical Facilities 💊
Manufacturing Operations Teams 🔍
👋

Any organization needing predictable AI costs and full workflow ownership — with on-premise deployment available for Enterprise

What Problems It Solves

Problem
Solution
Unpredictable API costs from multiple vendors
Fixed monthly pricing with no per-query surcharges
Billing fragmentation across multiple services
Single platform, single bill
Lack of control over where data is processed
Runs on CNAPS's secure cloud by default, with on-premise deployment for Enterprise
Complex setup requiring engineering teams
Drag-and-drop interface, no code required
Vendor lock-in and dependency on external services
Full model ownership, never lose access to capabilities

Pricing & Plans

Plan
FREE
STARTER
PRO
BUSINESS
ENTERPRISE
Pricing (monthly)
Free
$20
$75
$200
Custom
Pricing (yearly)
Free
$200
$750
N/A
Custom
Usage Capacity
Continuous access with basic capacity
High
Advanced
Scalable
Custom
Available Models
All
All
All
All
All
Batch Runs
x
Limited
Watermark
x
x
x
x
Team Menu
x
x
x
SSO/SAML
x
x
x
Webhook Control
x
x
x
Flow Versioning
x
x
x
Role-Based Access Control
x
x
x
📎

All plans include: flow template library · complete model flow ownership · regular model updates

🎁

2-Week Free Pro Trial - New users can try the Pro plan free for 2 weeks - full access to advanced usage capacity, all models, and Batch Run. Experience the full Pro feature set before deciding on a plan.

Home — Pick a Card, Get a Result

Home is where you land. Every card is a complete AI task that has already been built and tested for you — no canvas, no connections, no setup.

image

How it works:

  1. Find a card. Scroll the gallery, or type what you want in the search bar at the top — "make my video sharper", "remove the background", "poster of me".
  2. Open it. Every card opens with a finished example already on screen, so you can see exactly what it produces before you run anything yourself.
  3. Swap in your own input on the right — text, an image, an audio file, or a video.
  4. Click Run again. Your result replaces the example.
  5. Download what you like. Everything you make is also saved under My Work → My Creations.

Good to know:

  • New cards land continuously. Search is the fastest way to find one — the gallery is built to keep growing.
  • Works on mobile — browse cards, upload, run, and download results from your phone.
  • Some cards run several AI models at once and show the results side by side, so you can compare and keep the one you prefer. Turn Words into 4K Images, for example, returns three.
  • Each card shows an estimated run time before you start.
  • Need more control? Click Open in CNAPS Studio on any card to load that card's actual workflow onto the canvas. It is the fastest way to learn how flows are built — and the way to customize one.

Understanding the Basics

New here? Complete the Quickstart Guide first — your first result takes about 30 seconds, and your first flow comes right after.

What is a flow?

A flow is a series of connected steps that process your data automatically. Each step is called a node, and nodes are connected by lines that show how data moves.

Think of it like a factory assembly line:

  1. Raw materials enter (Input)
  2. Each station does one job (AI Models & Tools)
  3. Finished product exits (Output)

Node types

Input Nodes (data entry)

  • Image Loader — upload images (JPG, PNG, WEBP, AVIF)
  • Text Input — enter text data
  • Video Loader — upload video files
  • Sound Loader 🆕 — drop in an audio file, or switch to the Record tab and capture straight from your microphone, with a live waveform as you go recording works in Chrome and Firefox (WebM) and in Safari (MP4)

AI Model Nodes (smart processing)

Category
What it does
Audio Model (Text to Music)
Turns a written description of a style into a finished piece of music
Audio Understanding (Speech-to-Text)
Transcribe speech from video in 99 languages
Image Classification
Identify what's in an image
Image Control
Guide image generation with edge/depth maps (ControlNet)
Image Edit
Edit images, remove objects, inpaint masked areas
Image Enhancement / Upscaling
Make photos bigger & clearer
Image Generation
Generate images from text prompts (now with 16:9 & 9:16 output)
Image Restoration
Fix damaged, blurry, or degraded images
Image Understanding
Generate natural-language descriptions
Multimodal Language Models
Read, reason, and understand text, images & video
Object Detection
Detect & localize objects in images
Pose Estimation
Track 17 human body landmarks (OpenPose skeletons)
Image Segmentation
Identify every pixel by object type; remove backgrounds
Text Recognition (OCR)
Extract text from images
Video Generation
Generate videos from text or images (some with synchronized audio)
Video Segmentation
Identify every pixel by object type from videos
Video Upscaling
Restore and enhance videos — now up to 4K

→ Browse all models: AI Model Hub

Tool Nodes (data manipulation)

  • Annotation (1) — Canny Edge Annotator
  • Blur & Effects (5) — Image Blur (Fast / Standard / Simple), Lens Blur, Selective Blur
  • Color Adjustments (2) — Grayscale, Inverse
  • Comparison (3) — Image Compare, Video Compare, Text Compare
  • Image Blending (2) — Image Add, Image Multiply (now with auto-fit)
  • Image Masking (5) — Masker by Class / by Coord / by Region, Manual Masker, Object Picker
  • Image Resizing (3) — Resize, Conditional Resize, Resize to Match
  • Layered Tools (1) — Layer Compose
  • Selection & Extraction (15) — Color Pick by Class / by RGB Value, Crop by Class / by Coord / by Text, Image Selector, List Extract / List Inject, Image Gate by Text, Manual Color Picker, Manual Crop, Video Frame Extract, Video Reassemble, Video Split, Video Trim
  • Text Tools (4) — Draw Text, Region Extract, Text Concatenate, Text Decorator
  • Video Editing (18) — Audio Finish, Hook Teaser (Cold Open), Ken Burns (Still to Video), Narration Mux (Cold Open), Remove Dead Zone, Slice Transcript to Clips, Snap Segments to Speech, Video Caption, Video Clean Span, Video Concat, Video Constraint Map, Video EDL, Video EDL Planner, Video Narrate (Qwen3), Video Reframe (9:16), Video SFX, Video Speed, Video Subtitle (Spoken)

Output Nodes (View Results)

Where you see the final results.
  • Image Viewer — display processed images (resizable)
  • Text Viewer — display text results and data
  • Video Viewer — display generated/processed videos
  • Sound Output 🆕 — play the resulting audio, with its waveform displayed

AI-Generated Content Labels

When your flow uses AI models to generate or manipulate content, CNAPS Studio automatically labels the output — both in the viewer and in downloaded files.
image

Chain detection: If your flow has FLUX (image gen) → BiRefNet (segmentation) → Output, the segmentation output still shows the "AI-generated · FLUX Schnell" badge because the upstream chain contains generation. The badge tracks the earliest AI generation step in the flow.

Why it's there:

  • EU AI Act Article 50 requires AI-generated content to be identifiable
  • The badge tells anyone viewing the output that it came from an AI model — useful for compliance, journalism ethics, and end-user trust
  • CNAPS also embeds machine-readable provenance metadata in downloaded files

When it appears:

  • ✅ Flow includes any generative model (image generation, image editing, video generation, TTS, multimodal LLM, image captioning)
  • ✅ Flow includes OCR (labeled as "AI-extracted" not "generated" — to preserve accuracy)
  • ❌ Pure utility flows (upscaling, denoising, resize, blur, object detection) — no badge

Connecting Nodes: The Color System

Nodes have colored connection points (called "ports") showing what data type they handle:
  • 🔵 Blue dots = Image data
  • 🔴 Red dots = Text data
  • Light Blue dots = Video data
  • 🟢 Green dots 🆕 = Audio data
  • Multiple colors = Nodes that handle more than one type
image
image
📢

To connect nodes:

To connect nodes: hover over the colored dot on the right side of one node, then click and drag to the matching colored dot on the left side of the next node. Data always flows left → right. Colors must match — blue to blue, red to red.

Understanding Usage Capacity

CNAPS Studio measures your usage by GPU processing time - essentially, how much computing power your flows consume.
  • Each plan includes a set amount of usage capacity
  • Complex AI models use more capacity than simple tools
  • Capacity resets every 5 hours (rolling window)
  • Monitor real-time usage: your avatar → Usage
  • If you exceed capacity: processing pauses until the next reset, or upgrade for more

Ultimate Privacy Protection — One-Click Anonymization

A standalone web app for privacy-safe images — no workflow, no setup:

  1. Upload an image (PNG, JPEG, WebP, AVIF, BMP — up to 10 MB)
  2. Choose what to hide: Face, Tattoo, License Plate, Person, Logo, Text, or Custom (type anything)
  3. Get your anonymized image back on the same page
🎁

3 free images just for signing in — no subscription required.

Platform Guide

Interface Overview

Two panels run the whole product: the left sidebar takes you between Home, the canvas, and your work; the avatar menu in the top right holds your workspace, billing, and account settings.

New user? Complete the Quickstart Guide to familiarize yourself with the interface.

Left Sidebar (Navigation)

image
  • Home — the card gallery, with search at the top. See the Home section above.
  • CNAPS Studio — the full canvas. Opens a new blank flow where you can drag, connect, and configure nodes yourself.
  • Community — flows published by other users. Fork any of them into your own workspace, then run or modify them.
  • image
  • My Work
    • My Creations — every result you've made from a card on Home
    • My Flows — your flow library, with thumbnails, status, permissions, model counts, and last-modified dates. Search flows by name in real time, and Shift-click to multi-select for bulk delete or share. Per-flow actions: Add to Batch Run, Share, Publish to Community, Fork, Delete
    • image
    • Batch Runs — monitor batch executions, preview inputs/outputs, download results as ZIP
    • image
  • Shared with me — flows others have shared with you
  • image
  • API Key — generate keys for programmatic access (needed for Batch Run via API)

At the bottom of the sidebar

image
  • Appearance — switch the whole interface between Light, Dark, and System (System follows your operating system setting)
  • Guides — opens this documentation site

Collapse the sidebar with the toggle next to the logo when you want more room for the canvas.

Account & Workspace Menu (top right)

Click your avatar in the top-right corner.

Workspaces

  • Workspace switcher — switch between workspaces, or create a new one with + Business Workspace
    • Personal - For Free, Starter, and Pro users
    • Business - For Business users. You can create a business/team workspace here once you subscribe to the Business pricing plan.
  • Workspace Settings — four tabs: General, Billing, Usage, and Integrations
  • General
    1. image
    2. Workspace Icon: Upload a custom icon to personalize your workspace
    3. Workspace Name: Give your workspace a unique name
    4. Handle: A unique, taggable @username (e.g., @creator) for CNAPS Community
    5. Workspace Type: Displays whether this is a Personal or Business workspace
    6. Your Role: Displays your role within the workspace (relevant for Business plan team members)
  • Billing
    1. image
    2. View your current subscription plan and manage billing, upgrades, downgrades, or cancellations.
    3. Also linked directly in the avatar menu as a shortcut.
  • Usage
    1. image
    2. Track your usage capacity consumption for the current 5-hour period. The usage bar shows what percentage you've used, with your capacity automatically resetting every 5 hours.
    3. Also linked directly in the avatar menu as a shortcut.
  • Integrations - connect external AI services (Claude, OpenAI, Google). External models don't consume your CNAPS capacity — they bill through your own provider accounts

Account

  • Account Settings - profile, security (password/email), activity log, and account management. Interface available in 7 languages: English, Korean, Japanese, Chinese, Spanish, Arabic, French
  • Legal - terms and privacy
  • Docs - Guides · Quickstart · Models · FAQ
  • Sign Out

Main Canvas Area

Top bar

  • Flow title (top left) — click to rename. The back arrow beside it returns you to where you came from
  • image
  • Publish (top right) — share the flow to CNAPS Community
  • Run Flow (top right) — execute your flow. Use the dropdown beside it for Batch Run, which processes many files through the same flow
  • History (top right) — opens the Flow History panel. It records every edit in real time. Restore any previous state with a click, so you can experiment freely.
  • image

Canvas toolbar (left edge)

  • Add Node — opens the Component panel. Keyboard shortcut: N
  • image
  • New Flow — opens Start Your Flow: choose Blank Flow for an empty canvas, pick one of the ready-made templates, or jump to your library
  • My Flows — a quick switcher for your saved flows. Search by name, or browse Recent with node count and last-edited time on each row. Use ↑ ↓ to navigate and to open, or See all for the full library
  • Fork — make your own copy of the current flow, leaving the original untouched
  • Share — Three access modes plus per-person permissions — precise control, like Google Docs:
  • image
    Mode
    Who can access
    Discoverable?
    Private (default)
    Only the owner
    No — not visible to anyone else
    Link Sharing
    Anyone with the direct link
    No — not publicly listed
    Public
    Anyone with the link
    Yes — surfaces in public galleries / Community

    People with access: invite collaborators by name or email as Editor (view, run, modify) or Viewer (view & run only). Optional extras: require an access code, and notify invitees by email.

    🔒

    Per-Input Fork Control — When someone forks your flow, your uploaded images are NOT copied by default (text prompts are). A badge on each input node toggles between "copied when forked" and "excluded", so you can share workflows without sharing sensitive photos.

    Real-time collaboration: invite Editors and build together — everyone sees each other's cursors and changes live on the canvas, and anyone can Run Flow or Batch Run.

  • Editor Settings — canvas preferences, e.g. toggle auto-connect on drag
  • image

Component panel

Opens from Add Node and floats over the canvas, so it's there when you need it and out of the way when you don't.

  • IN / OUT row at the top — drop in Input and Output nodes for text, image, video, and audio
  • Search — find any model or tool by name
  • Filters — All, Hot, Text, Image, Video, Audio
  • 🔥 Hot Models — community favorites, each with ★ quality and ⚡ speed ratings
  • AI Models — the full library, grouped by category and expandable
  • Tools and External Models live in the same list

Bottom left — zoom control ( / +, with the current zoom level between them)

Canvas shortcuts:

Shortcut
Action
N
Open the Component panel
Shift + Drag
Select an area / multiple nodes
Ctrl + C / Ctrl + V
Copy & paste nodes (within or across flows)
Ctrl + Z / Ctrl + Shift + Z
Undo / Redo

Faster ways to add nodes:

  • Quick Add — drag a connection line onto empty canvas to open a node search menu
  • Right-click to add — right-click empty canvas for the same menu, plus Sticky Notes for annotating your workflow
  • image

🧩 Creating and Managing Flows

image

Starting a New Flow

1️⃣ Method 1: Blank Canvas (Most Control)

  1. Click CNAPS Studio in the left sidebar
  2. Name your workflow (click title in top left)
  3. Click Add Node and drag in the nodes you need
  4. Connect nodes with matching colored lines
  5. Configure each node's settings
  6. Upload test data to Input nodes
  7. Click "Run Flow" to test

2️⃣ Method 2: Use a Template (Fastest)

  1. Click New Flow on the canvas toolbar to open Start Your Flow
  2. Pick a template — Generative Upscaling, Seamless Object Removal, Instant Identity Masking, Ultra-Res Image Generation, Logo Detection & Extraction, and more
  3. It opens on the canvas with sample data loaded. Run it as it is, then customize inputs, settings, or nodes
  4. Save with a new name

** Check out our Quickstart Guide for more information

3️⃣ Method 3: Start from a card 🆕

Open any card on Home, then click Open in CNAPS Studio. The card's real workflow lands on your canvas, fully wired and ready to run — the fastest way to see how an experienced flow is put together, and the easiest place to start customizing.

Configuring Nodes

Each node has settings that control its behavior. Configuration options appear directly on the node card when you select it.

image

Click any node to see its settings directly on the node card. Common options:

  • Class — which object type to detect or process (e.g., "person", "car")
  • Confidence Score — minimum certainty threshold (0–100%); higher = fewer but more accurate results
  • Scale Factor — meaning depends on the node: an enlargement multiplier on upscaling models (e.g., 2x, 4x), or how much to downscale before blurring on Blur & Effects tools — see Glossary for exact ranges
  • Kernel Size — size of processing filter; larger = stronger effect
  • Diffusion Steps — refinement iterations for generative models; more = higher quality but slower
  • Random Seed — same seed = identical results every time (great for testing)
📢

Pro tips: start with defaults · change ONE setting at a time · check the AI Model Hub for parameter details · save versions to compare results.

Running Your Flow

image

Single Run (testing & development)

  1. Upload input data to Input nodes
  2. Verify connections
  3. Click Run Flow (top right)
  4. Watch progress — the currently-processing node glows
  5. View results in Output nodes; click to see full detail; download if needed

Visual cues during a run: animated button states (Default → Running → Done/Failed), glowing active node, smooth step-by-step progress bars, and background execution — flows keep running even if you switch tabs.

Batch Run (Production Processing)

image

Process up to 100 files through the same workflow at once.

Three input modes per node:

Mode
What it does
When to use
Batch
Different input value for each run
Bulk-processing distinct files (e.g., 100 product images)
Shared
One input value for all runs
A single reference image or prompt reused across the batch
Flow Value
Use the value already set in the workflow
Keep the flow's default

How to run a batch:

  1. Click Batch Run (top right) — one panel opens per input node (#1, #3, …)
  2. Choose Batch / Shared / Flow Value per input
  3. Drag & drop files or folders (up to 100 items)
  4. Files in the same row are paired and run together — use Export CSV / Import CSV to reorder pairings for complex batches
  5. Click Run Batch, then monitor at My Work → Batch Runs
  6. The completion email now links straight to your results — one click from inbox to download
  7. Download everything as a ZIP, or preview and download individual files

(Developers can also trigger batches via API — see API Integration below.)

Working with external models

Use AI services from Anthropic, OpenAI, and Google without consuming your CNAPS capacity — they bill through your own provider accounts.

Current external lineup:

  • Audio: Gemini TTS
  • Image/Video: GPT Image, Nano Banana, Sora2, VEO, Video Analysis (Gemini), Omni
  • Language: ChatGPT, Claude, Gemini

Setup:

  1. Get API keys — Anthropic · OpenAI · Google
  2. Paste them in your avatar → Workspace Settings → Integrations
  3. In the Component panel, external models show white text when ready (gray = needs API key)
⚠️

External models are billed by the provider, not CNAPS Studio. Check provider pricing before heavy usage — you're responsible for external billing. Note: Google retires Gemini 2.5 Pro/Flash on October 16, 2026 — plan your migration.

Working with Claude (MCP)

CNAPS Studio integrates with Claude via MCP (Model Context Protocol) — describe what you want in plain language and Claude assembles, runs, and debugs the workflow inside the chat:

  • Smart pipeline recommendations — multi-step requests like "colorize and upscale" become the correct pipeline automatically
  • Context-aware model selection — e.g., PiSA-SR for quality, SMFANet+ for speed, Swin2SR for large images
  • Actionable error diagnosis — plain-language explanations and fixes instead of generic failures
  • End-to-end execution in chat — no need to open the Studio and click Run manually

Connecting with n8n

Trigger CNAPS Studio flows from your existing n8n automations — chain image, video, and multimodal AI processing into any n8n workflow using your CNAPS.ai API key:

  • No-code trigger — kick off a CNAPS.ai flow from any n8n node (webhook, schedule, email, Slack, etc.)
  • Batch and single-run support — send one file or many through the same workflow
  • Pass results downstream — return the CNAPS.ai output (image URLs, extracted text, generated video) into the rest of your n8n pipeline

→ Full setup, node reference, and example recipes: see the n8n Guide.

Connecting with Zapier

Run CNAPS Studio flows as steps inside a Zap, alongside the 9,000+ apps Zapier already automates:

  • Any trigger, any destination — start from Gmail, Slack, Airtable, Shopify, a form, or a schedule, then send results wherever they need to go
  • Predictable, repeatable runs — you pick the tools and their order when you build the Zap, so every run behaves identically
  • Sign in with OAuth — connect with your CNAPS.ai account; no API key to paste, store, or rotate

→ Full setup, field mapping, and known pitfalls: see the Zapier Guide.

Common Challenges & Solutions

This section addresses the most frequent issues users encounter, especially those new to AI workflows.

Challenge #1: "I don't understand what to do"

This is the #1 feedback from beginners. You're not alone! Here's a structured approach to overcome this:

First: Complete the Quickstart If you haven't already, go through our Quickstart Guide. Building that first simple flow gives you essential hands-on experience.

Learning strategy on the canvas:

  1. Phase 1 — Don't build from scratch yet. Open a sample template, click Run Flow with defaults, and watch what each node produces.
  2. Phase 2 — Make small changes. Change just ONE thing (input image, one setting, one class name), run again, compare.
  3. Phase 3 — Build your own. Start with 3–4 nodes (Input → One AI Model → Output), get it working, then add complexity gradually.

Common confusion points:

  • Which AI model should I use? Start with 🔥 Hot Models, compare 2–3 similar ones, check star ratings, and read the AI Model Hub
  • What do these settings mean? Start with defaults; change one at a time; see the Glossary below
  • What connects where? Match the colors, data flows left → right, Input → Processing → Output
  • Flow not doing what I expected? Add Output nodes after EACH step to see intermediate results

Still stuck? Watch video tutorials or browse CNAPS Community for working examples to fork.

Challenge #2: "The AI model didn't work as I expected"

This is common because AI models have different training and vocabularies.

Solution 1: Try Different Models

CNAPS Studio provides multiple models for similar tasks:

Task
Alternative Models
Image Segmentation
SAM2, SAM3, SAM3.1
Object Detection
DETR, YOLO
Image Enhancement
PiSA-SR, SwinIR, SMFANet+

Solution 2: Resize Strategically

Many models work best at specific sizes:

  • 512x512: Most computer vision models
  • 1024x1024: Higher resolution models
  • Original size: OCR, text extraction

If detection fails:

  • Try resizing to 512x512 or 1024x1024
  • Very large images might lose accuracy
  • Very small images might miss detail

Challenge #3: "My flow is taking too long"

Long processing times usually have specific causes with specific solutions.

Common Causes & Fixes:

Cause 1: Processing Very Large Images

Symptoms:

  • Single image takes 30+ seconds
  • GPU usage maxed out
  • Slow progress through nodes

Solution: Resize BEFORE processing:

Input → Resize (512x512) → [AI Models] → Upscale → Output

Why this works:

  • Most AI models are optimized for 512x or 1024x
  • Smaller inputs process 10x faster
  • Upscale at the END to restore quality
  • No visible quality loss for most tasks

Cause 2: Chaining Multiple Upscaling Models

Symptoms:

  • Flow takes minutes per image
  • Multiple upscalers in sequence
  • Capacity depletes quickly

Problem flow:

Input → 4x Upscale → 4x Upscale → 2x Upscale = 32x total (extremely slow)

Solution: Only upscale once at the end:

Input → [Process at 512x] → Single 2x Upscale → Output

If you need 4x:

  • Use one 4x upscaler, OR
  • Use two 2x upscalers maximum
  • Never more than 2 upscalers total

Cause 3: Using Too Many Heavy Models

Heavy models:

  • Upscalers (PiSA-SR, FlashVSR, SeedVR2, SparkVSR)
  • Generative models (Image/Video Generation, Object Removal)
  • Complex segmentation

Solution: Simplify your flow:

  • Remove redundant processing steps
  • Use lighter models where possible
  • Test each model individually first
  • Consider if you need ALL those steps

Cause 4: Batch Processing Large Numbers

Symptoms:

  • Batch run shows "Processing" for hours
  • Hundreds of files in queue

This is actually normal!

Understanding:

  • Batch processing is meant for unattended operation
  • Large batches naturally take time
  • System processes files sequentially
  • Progress shown in Batch Runs page

Solutions:

  • Expected: Let it run (check back later)
  • Faster: Break into smaller batches (50-100 files)
  • Overnight: Schedule during off-hours

Optimization Tips:

For Faster Processing:

  1. Resize to 512x as first step
  2. Use 2x upscaling instead of 4x
  3. Minimize number of AI models in chain
  4. Test on small batches first
  5. Remove unnecessary processing steps

For Quality vs Speed Trade-offs:

  • Prioritize speed: Resize smaller, use 2x upscale, fewer models
  • Prioritize quality: Larger inputs, 4x upscale, more refinement
  • Balance: 512x processing + single 2x upscale works for most

Challenge #4: "I exceeded my usage capacity"

Your capacity resets every 5 hours automatically, but here's what to do:

Immediate Solutions:

Option 1: Wait for Reset

  • Check My Work → Usage for timer
  • Capacity resets every 5 hours (rolling window)
  • Plan work around reset schedule

Option 2: Upgrade Your Plan

  • Your avatar → Billing
  • Higher tiers = more capacity per 5-hour period
  • Compare plans to see limits

Optimize Your Flows:

  • Resize images to 512x before processing
  • Use 2x upscaling instead of 4x when possible
  • Remove unnecessary model chaining
  • Test with small batches first

Spread Usage Throughout Day:

  • Don't process everything at once
  • Utilize the 5-hour reset cycle
  • Process in smaller batches across resets

Reserve Capacity:

  • Save capacity for critical work
  • Process non-urgent items during off-peak
  • Monitor usage regularly

Track Patterns:

  • Your avatar → Usage shows historical data
  • Identify which flows consume most capacity
  • Optimize high-usage workflows

Challenge #5: "The output looks wrong or unexpected"

Systematic Troubleshooting:

Step 1: Check Each Node Individually

Add temporary Output nodes after each step:

Input → [Output 1] → Model A → [Output 2] → Model B → [Output 3] → Final Output

Process:

  1. Run the flow
  2. Check Output 1: Is the input correct?
  3. Check Output 2: Did Model A work correctly?
  4. Check Output 3: Did Model B work correctly?
  5. Identify WHERE things go wrong

Step 2: Check Input Quality

Your input affects output quality:

Good inputs:

  • Clear, well-lit images
  • Reasonable file size and resolution
  • Correct format (JPG or PNG)
  • Not heavily compressed or corrupted

Bad inputs:

  • Extremely dark or bright images
  • Tiny thumbnail-sized images
  • Heavily compressed or degraded
  • Wrong file format

Quick test: Try the flow with a sample image from a template to see if it works correctly.

Step 3: Try Different Models

If one model produces poor results:

  1. Swap it for an alternative model (same category)
  2. Try models with higher star ratings
  3. Compare results between 2-3 options
  4. Different models have different strengths

Step 4: Simplify and Rebuild

If output is completely unexpected:

  1. Create a new blank flow
  2. Add just Input → Problematic Model → Output
  3. Test if model works in isolation
  4. Gradually add back other nodes
  5. Identify which combination causes issues

API Integration

🔑

What is an API Key?

API keys allow you to execute batch runs programmatically via the CNAPS Studio API. You'll need an active API key to use the "Call via API" method in Batch Run.

Getting Your API Key

Creating an API Key

  1. Open API Key - Click API Key near the bottom of the left sidebar.
  2. Click "+ Create New Key" - You'll see a button in the top right. Click it to open the key creation form.
  3. Configure Your Key - Fill in these settings:
    1. Description - Give your key a meaningful name
    2. Expiration - Choose when this key expires:
  4. Click "Create" - CNAPS Studio generates your unique API key
  5. IMPORTANT: Copy & Save Your Key ⚠️ - Your key will only be shown once. After you close this window, you cannot view it again.
  6. Copy the key - Click the ‘Copy’ button and Save it somewhere secure.
    1. If you close the window without copying: Don't panic — regenerate the key (see next section).
    2. The old key will still work until you delete it.

Using Your API Key

  • Use this key in the x-api-key header when making API calls for Batch Run
  • Find the complete usage example in Batch Run > Call via API
  • Find your keys anytime under API Key in the left sidebar

Managing Your API Keys

image

After creating a key, you can see it listed in the API Key menu with three options:

  • Deactivate - Use when you temporarily want to stop using a key without deleting it
  • Regenerate - Use when you think your key might be compromised or want to update it
  • Delete - Use when you no longer need this key

Web console only. API keys can only be created, viewed, regenerated, and deleted here in the web console. Key management is deliberately not exposed as an MCP tool or API endpoint, so an automated agent cannot issue itself a new key or delete one you depend on.

Batch Run via API

Go to Batch Run and click the "Call via API" dropdown to access technical integration details:

  • ENDPOINT: The API URL for programmatic batch run execution
    • Format: POST https://cnaps.ai/api/v1/batch-runs/run
    • Click "Copy" to copy the endpoint
  • HEADER: Your authentication key
    • Format: x-api-key: YOUR_API_KEY
    • Get your API key from API Key in the left sidebar
    • Click "Copy" to copy the header
  • FORM DATA: Required parameters for the API call
    • flow_id: Your workflow's unique identifier
    • -@your_file.png: File paths (repeatable for multiple files)
    • Click "Copy ID" to copy your flow ID
  • CURL EXAMPLE: Ready-to-use command line examples
    • Toggle between Linux/macOS, Windows CMD, and PowerShell
    • Complete curl command with your flow ID and file paths
    • Click "Copy" to copy the command
    • Replace YOUR_API_KEY and file paths with your actual values

After Running:

  • Monitor execution status in the Batch Runs page
  • View processing duration and completion time
  • Preview input and output files
  • Download all results as a ZIP file

MCP Guide

Connect Claude to CNAPS Studio via MCP and build workflows through natural language — no clicking through the interface, no manual node-wiring. The server exposes 33 tools, identical whether you connect via OAuth or an API key. The full setup guide, tool reference, and example recipes are on the dedicated page below:

CNAPS.ai MCP Server — User Guide

n8n Guide

Trigger CNAPS Studio flows from your existing n8n automations. Chain CNAPS image, video, OCR, and multimodal AI models into any n8n workflow using your CNAPS API key — no code required. The full setup guide, node reference, and example recipes are on the dedicated page below:

Connect CNAPS.ai to n8n — MCP Integration Guide

Zapier Guide

Run CNAPS Studio flows from Zapier and connect them to the 9,000+ apps Zapier already automates. The MCP Client integration exposes all 33 tools as Zap actions over OAuth, so a fixed pipeline runs the same way every time — upload a file, build a flow, return the result. The full setup guide, field-mapping reference, and known pitfalls are on the dedicated page below:

Connect CNAPS.ai to Zapier — MCP Integration Guide

Glossary

Term
Definition
AI Models
Node type that processes data with artificial intelligence. Examples include Vision Transformer (classification), Swin2SR (image upscaling), and PaddleOCR (text extraction)
Batch Run
Option to process multiple input files or data items at once. More efficient for processing large amounts of data. Click the "Batch Run" button in the top right corner
Canvas
The central workspace where you visually design your flows by placing and connecting nodes
Class
Configuration option for classification models. Specifies which category or class to focus on or detect. Used to filter or prioritize results for specific object types or categories
Brightness Multiplier
Configuration option for image processing models and tools. Adjusts the intensity or saturation of brightness in the output.
Confidence Score
A percentage (0-100%) indicating how confident the model is in its result. Higher is better. Example: "91% confident this image is a cat”
Dilation
Configuration option for morphological operations in image processing. Controls the expansion of white regions in binary images. Higher dilation values expand objects and fill small holes. Used in edge detection and object refinement
Diffusion Steps
Configuration option for generative models like Image Eraser. Controls the number of denoising steps in the diffusion process. More steps = higher quality but slower processing
Error Message
A message displayed by CNAPS Studio when something goes wrong during flow execution, explaining what went wrong and how to fix it
Flow
A series of connected steps that CNAPS Studio executes automatically. Combines input nodes, AI models, tools, and output nodes to process data from start to finish
My Flows
Your collection of saved flows. Access via "My Flows" in the navigation menu. For each flow you can change permissions, rename, open, or delete
Flow Template
Pre-built flow that you can use as a starting point. Choose from sample templates or create your own. Templates save time and provide best-practice patterns
Guidance Scale
Configuration option for generative models. Controls how strongly the model follows instructions or conditioning input. Higher values = stricter adherence, lower values = more creative variation
Iterations Numbers (of Gaussian Blur)
Configuration option for image smoothing and blur effects. Specifies how many times the Gaussian blur filter is applied to the image. More iterations = stronger blur effect. Typical range: 1-5 iterations for increasing blur strength
Kernel Size
Configuration option for image filtering and convolution operations. Specifies the size of the filter matrix applied to the image (e.g., 3x3, 5x5, 7x7). Larger kernel sizes affect larger areas of the image, producing stronger effects. Used in blur, edge detection, and other filtering operations
MCP (Model Context Protocol)
Open standard that lets AI assistants and automation platforms — Claude, n8n, Zapier — assemble, run, and debug CNAPS Studio flows through natural language or workflow steps
Model
A trained AI system. Example: Vision Transformer is a model that classifies images into different categories
Node
A single step in a flow. Each node does one specific thing. Types include Input Nodes, AI Models, Tools, and Output Nodes
NSFW
Not Safe for Work (= Adult Content)
Random Seed
Configuration option for generative models and diffusion-based tools. Sets a seed value for reproducibility. Using the same seed produces identical results. Useful for testing and ensuring consistency
Run Flow
Option to process one single item at a time. Upload input data to an Input Node, click "Run Flow" button, and watch it execute through each node. Results appear immediately after processing completes
Scale Factor (Blur & Effects)
Configuration option for the Image Blur (Fast) tool. Controls how aggressively the image is downscaled before the Gaussian blur is applied and then upsampled back to original size — higher values blur more and process faster, at the cost of detail. Range: 2–30 (integer), default 10
Scale Factor (Image Upscaling)
Configuration option for upscaling models (e.g., SwinIR, PiSA-SR, SMFANet+). Sets the enlargement multiplier — how many times larger the output is versus the input. Common values: 2x, 3x, 4x (8x on SwinIR only)
Tool
Node type that transforms or manipulates data. Examples include Resize, Crop, Extract Text, and Filter. Used to prepare data before AI processing or refine results after processing

Additional Resources

Getting Started:

QuickstartFAQAI Model HubRelease NoteUltimate Privacy Protection - AI Image Anonymization & Face Blur Tool

Last Updated: Sep 2nd, 2026