TwinTale Docs
Getting Started
Set up your first project in minutes
1. Get Your API Key
- TwinTale uses Google Gemini API for image generation.
- Visit Google AI Studio and create a free API key
- Store it securely - you'll need it for all generations
- Free tier provides generous rate limits for development
2. Create Your First Comic
- Navigate to the Demo page or Dashboard
- Select "AI Comic Generator" from the tools
- Write a story prompt (e.g., "A robot learning to dance")
- Optionally upload reference images for character consistency
- Click "Generate Now" and wait 30 seconds
- Your 4-panel comic will be generated with consistent characters
3. Understand Brand Twins
- Brand Twins are reference images that guide character consistency
- Upload 1-5 images of the character/style you want to maintain
- The AI analyzes these images to replicate the visual style
- Works best with clear, well-lit reference images
- Same Brand Twin can be used across multiple projects
- Save your Brand Twins to the dashboard for reuse
Available Tools
Three powerful tools for visual content creation
AI Comic Generator
- ✓ Creates 4-panel comic strips with consistent characters
- ✓ Perfect for storytelling, marketing, and entertainment
- ✓ Each panel is independently generated but visually coherent
- ✓ Square aspect ratio (1:1) optimized for clarity
- ✓ Narrative structure: Hook → Rising Action → Climax → Resolution
- ✓ Best for: Brands with character mascots, narrative ads, webcomics
Carousel Maker
- ✓ Generates 4-slide carousel posts for Instagram & social media
- ✓ Multiple aspect ratio options: 1:1, 4:5, 9:16, 4:3
- ✓ Designed for engagement with scroll-stopping visuals
- ✓ Slide sequence: Hook → Value → Trust/Proof → Call-to-Action
- ✓ Maintains consistent branding across all slides
- ✓ Best for: Social media campaigns, product launches, educational content
Visual Translator
- ✓ Localizes images by translating in-image text
- ✓ Single image input, one translated output
- ✓ Supports any language (Spanish, Japanese, French, etc.)
- ✓ Preserves layout, colors, and design - only translates text
- ✓ Pixel-perfect replication for seamless localization
- ✓ Best for: Multi-market campaigns, international ads, localized content
Core Features
What makes TwinTale different
Consistent Character Generation
- AI analyzes your Brand Twin reference images
- Maintains character appearance across all panels/slides
- Handles clothing, pose variations, and expressions naturally
- Works with original characters, mascots, or people
- Multi-panel consistency is TwinTale's core strength
- No more generic AI outputs - your characters stay true to brand
Prompt Precision & Control
- Detailed story prompts guide generation quality
- The more specific your prompt, the better the output
- Include: character actions, setting, mood, and context
- Example: "A detective discovering a hidden clue in a library at midnight"
- Avoid: vague descriptions or conflicting instructions
- Test and iterate - refine prompts based on results
Seamless AI Image Generation
- Powered by Google Gemini 3.0 Vision model
- Fast generation (typically 10-30 seconds)
- High-quality 1024x1024 base resolution
- Pro tier supports 4K resolution output
- No watermarks on saved files (watermark for demo only)
- Batch processing available for multiple projects
Advanced Features
Unlock more power with Pro
Pro Plan Benefits
- ✓ Unlimited daily requests (vs. 20 free)
- ✓ 4K resolution output (vs. 1024x1024)
- ✓ Unlimited Brand Twins (vs. single use)
- ✓ Priority processing queue
- ✓ Batch generation up to 6 panels
- ✓ Access to new features first
- ✓ $19/month or bring your own API key
Bring Your Own Key (BYOK)
- ✓ Use your own Google Gemini API key directly
- ✓ Pay only for what you consume at Google's rates
- ✓ No TwinTale markup on API costs - full transparency
- ✓ Full control over rate limits and billing
- ✓ Perfect for high-volume users and teams
- ✓ Seamless setup in Dashboard → Settings → API Keys
- ✓ Scale without constraints or overage charges
- ✓ Keep all generated images permanently
- ✓ Ideal for: Agencies, enterprises, high-volume creators
Localization & Multi-Language Support
- Translate content to 100+ languages
- Visual Translator tool handles in-image text
- Generate comics in target language by adjusting prompts
- Maintain visual consistency across language versions
- Cultural adaptation for regional markets
- Perfect for global marketing campaigns
Technical Details
How TwinTale works under the hood
Generation Process
- 1. User uploads Brand Twin reference images (optional)
- 2. Prompt is processed and context is extracted
- 3. Gemini API analyzes reference images for visual patterns
- 4. AI generates image based on prompt + reference guidance
- 5. Image is validated and returned to user
- 6. User can download or regenerate
Supported File Formats
- Input: JPEG, PNG for reference images
- Output: JPEG (watermarked in demo, clean in app)
- Recommended: PNG for best quality reference images
- Max file size: 5MB per image
- Max upload: 5 images per project (1 for translator)
Performance & Limits
- Free: 20 requests/day, 1024x1024 resolution
- Pro: Unlimited requests, 4K resolution
- Generation time: 10-30 seconds typically
- Batch mode: Up to 6 panels (Pro only)
- Concurrent requests: 3 per minute (Free), unlimited (Pro)
- Images stored: 30 days retention on server
Secret Prompting Techniques
Advanced strategies for Gemini 3.0
1. Role-Based Prompt Engineering
Start with an AI role assignment to guide generation style:
prompt "You are a viral content engine. Your mission is to..."TwinTale uses role statements like "viral content engine", "social media design AI", and "global market domination engine" to establish context and quality expectations.
2. Mandatory Rules Override
Use MANDATORY RULES to enforce strict formatting:
prompt MANDATORY RULES:
1. **VISUALS ONLY:** Clean image output. Do NOT draw borders.
2. **SQUARE FORMAT:** Perfect 1:1 aspect ratio.
3. **ABSOLUTE CONSISTENCY:** Characters stay identical.Capitalized "MANDATORY RULES" carries more weight with Gemini. This prevents panel borders, incorrect ratios, or style breaks.
3. Reference Image Integration
Explicitly mention reference images in prompts:
prompt "Use the reference images provided. Maintain perfect visual consistency for characters across all panels and scenes."Mentioning reference images activates Gemini's visual analysis capabilities for consistent character generation.
Pro Tips
Best practices for better results
Write Detailed Prompts
Instead of "a cat", try "a fluffy orange tabby cat wearing a red scarf, sitting on a windowsill at sunset"
Use High-Quality References
Upload clear, well-lit images. AI learns visual style better from professional-looking references.
Test & Iterate
Regenerate as needed. Try slight prompt variations if first results don't match expectations.
Plan Your Narrative
For comics, outline your story first. Better planning leads to more coherent multi-panel sequences.
Frequently Asked Questions
Q: How long does generation take?
A: Typically 10-30 seconds per image. First request may take slightly longer as API warms up.
Q: Can I use generated images commercially?
A: Yes! Free tier watermarks in demo mode. Pro users have full commercial rights.
Q: What if I don't like the result?
A: Regenerate! Tweak prompts, adjust references, or try different settings. 20 free attempts daily.
Q: How do Brand Twins work?
A: Brand Twins are reference images. AI analyzes visual characteristics and applies them to new generations.
Q: Can I use my own API key?
A: Yes! With BYOK, connect your Google Gemini API key directly. Pay Google with no TwinTale markup.
External Resources
Official documentation and tools