Tanumo Documentation6 min readTanumo v2.4+

User Guide & Documentation

Explore the complete Tanumo AI visual workflow: from node-based canvas structuring, creative conversational AI, multi-tier generation models, to resource market sharing and developer API keys.

Popular searches:
文档/Getting Started/Quick Start
CHAPTER 01

Getting Started Guide

Launch your first visual workflow in Tanumo in three quick steps — from setting up your canvas to exporting production-ready assets.

01

Create a Project & Open the Canvas

Click '+' in the left sidebar to create an isolated project for a brand or product line. Enter your workspace with a ready canvas — start from scratch or pick a starter template.

02

Build Node Workflow or Chat with AI

Add Prompt Input nodes and Image Reference nodes on the canvas, connect them to Generation nodes, or describe your idea to the Creative AI Assistant on the right to auto-wire the graph.

03

Submit Generation & Manage Assets

Configure resolution and quality, then click Generate. The job enters the cloud queue. Once finished, inspect high-res versions in the lightbox, download lossless PNGs, or iterate further.

Pro Tip:Canvas shortcuts: hold Space or toggle Hand tool (H) to pan, Selection tool (V) for marquee multi-select, and ⌘+Enter / Ctrl+Enter to immediately enqueue generation.
文档/Getting Started/Visual Canvas
CHAPTER 02

Node-Based Canvas & Visual Workflows

Tanumo decouples prompts, reference images, and outputs into visual nodes, allowing flexible wiring and multi-asset parallel production on a single infinite canvas.

1

Three Core Node Types

Prompt Input Node: Write descriptions or receive AI-refined prompts. Image Reference Node: Place uploads or existing assets as style anchors. Generation Node: Set models, aspect ratios, and quality to produce images.

2

Visual Graph Wiring

Drag wires from the right output dot of an input or reference card to the left input dot of a generation card. One prompt can drive multiple sizes, and one reference image can unify an entire series.

3

Canvas Toolkit & Organization

Marquee selection with Shift multi-select, grouping and ungrouping cards, one-click Auto Layout, canvas lock/unlock, and 25%–200% zoom with Fit View.

4

Lightbox & Version Iteration

Click any finished card to open the high-res lightbox, review candidate variants from the same run, download lossless assets, and click 'Edit Based on Image' to evolve the design.

5

Studio Trash & Safe Recovery

Individually deleted image cards are stored in the sidebar Trash for 7 days with one-click restore. Deleting an entire project immediately purges all associated data and cloud storage.

Pro Tip:Access the Onboarding Checklist and 30-second feature guide anytime from the canvas empty state to help teammates get up to speed quickly.
文档/AI & Generation Engine/AI Co-pilot
CHAPTER 03

Creative Conversational AI Assistant

The persistent right-side AI assistant is both a creative co-pilot and a canvas operator that understands your current workspace context.

1

Natural Language to Production Prompts

Describe your concept in plain words. The assistant automatically structures the core subject, lighting, materials, composition, and environment into high-performance prompts.

2

Quick Prompt Actions

Trigger one-click actions: 'Analyze Composition & Colors', 'Style Redesign Advice', 'Extract Prompt from Image', 'Enrich Prompt Details', and 'Generate Style Variants'.

3

Direct Canvas Orchestration

The assistant can directly add/remove nodes, wire connections, apply auto-layout, and insert refined prompts into selected cards — with full one-step undo support.

4

Selection Context Awareness

Select any input or image card on the canvas, and the AI assistant automatically uses it as conversational context to provide tailored enhancements and variation ideas.

Pro Tip:Conversation history is saved alongside each project so you can easily review previous creative discussions and prompt variations anytime.
文档/AI & Generation Engine/Image Engine
CHAPTER 04

Models, Generation Settings & Size Presets

Flexible multi-tier model power, multi-reference fusion, multi-channel platform aspect ratios, transparent background PNGs, and custom resolutions.

1

Multi-Tier Model Capabilities

Choose between Standard, Utility, Pro, and Utility Pro tiers — spanning cost-effective exploratory concepts to ultra-high-definition 4K commercial delivery.

2

Multi-Reference Image-to-Image

Attach up to 4 reference images (from project assets, local uploads, or Ctrl+V clipboard paste) to seamlessly inherit composition, subject contours, and color palettes.

3

Platform Size Presets & Custom Dimensions

Built-in presets for standard ratios (1:1, 3:2, 4:3), social media (XHS, WeChat, TikTok, X/Twitter, Instagram), and ecommerce (Taobao, Amazon banners), with 16px-increment custom size support.

4

Transparent Background PNGs

Toggle transparent background mode to output cut-out PNGs directly. Fine-tuned for ecommerce product packshots, transparent packaging, and multi-layer composites.

5

Quality Levels & Variant Generation

Select Low, Medium, or High quality; generate 1 to 4 candidate variants per run, with all outputs automatically organized in the asset version history.

Pro Tip:Custom dimensions are automatically validated against engine requirements (16px multiples, max 3840px per side, max 3:1 aspect ratio) for flawless generation.
文档/AI & Generation Engine/Task Queue
CHAPTER 05

Cloud Job Queue & Batch Processing

Persistent PostgreSQL job queues handle asynchronous high-volume generation with upfront credit estimates and automatic failover.

1

Persistent Cloud Task Queue

All jobs run asynchronously via background workers. You can freely refresh the page, switch projects, or close your browser without interrupting in-flight generations.

2

Upfront Transparent Credit Estimation

Before submitting any single or batch generation, the estimated credit cost is displayed next to the button based on chosen model, size, quality, and reference inputs.

3

Batch Canvas Generation & Scope Confirmation

Trigger batch generation across all eligible cards on the canvas. A secondary confirmation dialog clearly outlines the asset list, settings, and total credits before processing.

4

Automatic Failure Refund

If upstream model timeouts, policy filters, or network errors interrupt generation, reserved credits are automatically and fully refunded to your balance.

Pro Tip:The bottom-right queue indicator shows live pending and in-progress job counts; click it to expand the job list or jump to the active card.
文档/Assets, Market & API/Community
CHAPTER 06

Resource Market & Canvas Sharing

Browse production-tested canvas templates from the community, import complete projects in one click, or publish your own workflows to build your creator brand.

1

Explore Canvas Resources

Open the Resource Market from the sidebar to discover curated visual workflows categorized under Creation, Business, and Lifestyle, complete with node layouts and preview samples.

2

One-Click Import as New Project

Click 'Import as Project' on any market card to clone the complete node graph, prompts, and reference images into your workspace as an independent, fully editable project.

3

Publish Workflows & Review Process

Share your best visual series by clicking 'Publish to Resource Market' on the canvas page. Fill in title, design intent, and tags to submit for review and public showcase.

4

Likes & 'My Submissions' Management

Like and bookmark great resources; track your draft, pending review, and published submissions directly within the 'My Submissions' panel.

Pro Tip:Imported market resources run entirely within your account — your edits will never affect the creator's published original.
文档/Assets, Market & API/Account & API
CHAPTER 07

Credits, Billing Ledger & API Keys

Transparent credit balances, detailed consumption ledgers, and developer API Key integration for external MCP agents.

1

Permanent Credit Packs

Choose Creator, Studio, or Agency credit packages. Purchased credits never expire; the system automatically deducts promotional bonus credits first.

2

Billing Ledger & Usage Analytics

Track top-up records, generation costs, task durations, and per-job statuses in the Account Billing tab with complete audit trails.

3

API Keys & MCP Integration

Generate secure API keys to integrate Tanumo generation capabilities into Cursor, Claude Desktop, DSH, and custom agents via the official @tanumo/mcp-server.

4

Profile & Security Management

Customize display name, upload user avatars (JPG/PNG/WebP), and configure email password authentication for secure access.

Pro Tip:API Keys are shown only once upon creation. Copy and store them securely in your local environment variables or client configuration.
文档/Assets, Market & API/FAQ
CHAPTER 08

Frequently Asked Questions

Essential answers regarding queue times, prompt engineering strategies, commercial licensing, and technical support.

常见使用疑难与排查
·
Jobs are processed sequentially in the cloud queue, taking approximately 30–90 seconds per image. You can switch projects or close the window safely; results auto-sync once complete.
Pro Tip:For enterprise needs, bulk licensing, or general inquiries, feel free to reach out via the Feedback dialog or Contact page.

Was this documentation helpful?

你的反馈能帮助我们不断完善文档结构与功能说明。