Complete User Manual

MarketingAI Platform Guide

Everything you need to create, manage, and scale AI-powered marketing across every channel — text, images, video, voice, and email.

20+ AI Engines
Gemini 2.5 Flash
Grok 3 + Aurora
Imagen 3 GA
Veo 3 Video
Claude Sonnet
Cloud TTS + gTTS
🚀
Getting Started
Account setup, login, and first project

MarketingAI is a full-stack AI marketing platform hosted at marketing.nocodeai.cloud. It combines Gemini 2.5, Grok 3, Imagen 3, Veo 3, Claude Sonnet, and Google Cloud TTS to generate text, images, video, and audio from a single dashboard.

1
Create Account

Click Sign Up on the login screen. Enter your email and password. You'll be assigned the Free plan (10 text / 5 image / 2 video generations per month).

2
Log In

Enter your credentials. Your JWT token is stored in localStorage and automatically sent with every API request. Sessions last 30 days.

3
Create Your First Project

Go to Settings → Projects and click New Project. Each project represents a brand or client. All content, profiles, and social accounts are scoped per project.

4
Set Up Company Profile

Navigate to Company Profile (under Accounts & Profile in the sidebar). Fill in mission, vision, tagline, brand voice, and USP. This context is automatically injected into AI generation prompts.

Projects & Multi-Brand Management

Each project has its own isolated set of: Social Accounts, Company Profile, SOPs, Logos, Content, Campaigns, and Billing Ledger entries.

📁 Project Selector

The project dropdown at the top of Social Hub and Company Profile pages lets you switch between brands instantly.

🔒 Data Isolation

All BigQuery queries are scoped by user_id AND project_id — no cross-contamination between brands.

🤖 Context Injection

When your Company Profile is filled, the AI automatically uses your brand voice, industry, and USP in every generation prompt.

✍️
Content Writer AI
Generate social posts, blog articles, email copy, ad copy with Gemini or Grok

The Content Writer uses Gemini 2.5 Flash (primary) or Grok 3 (selectable) to generate platform-optimised social media posts, long-form articles, email subject lines, and ad copy.

Social Post Generation

1
Select Platform

Choose from LinkedIn, Instagram, Facebook, Twitter/X, TikTok, YouTube, or Pinterest. The prompt is automatically tailored to each platform's best practices.

2
Choose AI Engine

Select Gemini 2.5 (fast, high-quality, default) or Grok 3 (xAI, different creative style). Both return the same structured response.

3
Set Tone

Professional, Casual, Humorous, Inspiring, Educational, or Persuasive.

4
Generate & Copy

The response includes: post text, hashtags, best posting time, engagement prediction, and a suggested image prompt.

Pro Tip: Fill in your Company Profile first — the AI automatically uses your brand voice and industry context to produce on-brand content without extra prompting.

Content Types

Content TypeDescriptionTypical Output
Social PostPlatform-specific postText + hashtags + emoji + best time
Blog ArticleLong-form SEO articleTitle + sections + meta description
Email CopyMarketing email bodySubject line + preview + body + CTA
Ad CopyPaid advertising copyHeadline + description + CTA variants
Product DescriptionE-commerce copyShort + long description + features
🎨
Visual Studio AI
Generate marketing images with Imagen 3 or Grok Aurora

Visual Studio uses Google Imagen 3 (GA, `imagen-3.0-generate-002`) as primary and Grok Aurora (`grok-2-image`) as fallback/alternative to generate professional marketing visuals.

Image Storage: All generated images are automatically saved to Google Cloud Storage (gs://marketingai-assets/) and returned as permanent public URLs you can use anywhere.

Image Types

📸 Social Graphics

Square, portrait, or landscape images optimised for Instagram, LinkedIn, Facebook, TikTok.

🛒 Product Shots

Clean product photography on white or branded backgrounds. Ideal for e-commerce and ads.

📢 Ad Creatives

Banner ads, story formats, and display advertising with your brand context.

🖼️ Brand Imagery

Hero images, background textures, and lifestyle photos for websites and presentations.

Aspect Ratios

RatioUse Case
1:1 (Square)Instagram feed, Facebook posts, LinkedIn
16:9 (Landscape)YouTube thumbnails, Twitter/X cards, website hero
9:16 (Portrait)Instagram Stories, TikTok, Pinterest
4:3Presentations, blog headers
🎬
Video Studio AI
Generate marketing videos with Veo 3 or Grok-assisted workflow

Video Studio supports two generation modes: Veo 3 Direct (Google's latest video model) and Grok-assisted (Grok 3 writes optimised script + shot list → Veo 3 renders).

⚡ Veo 3 Direct

Enter a prompt, select duration (5s / 10s / 30s) and aspect ratio. Veo 3 renders directly. Best for short, high-quality clips.

🤖 Grok-Assisted

Grok 3 generates a full production script with scene descriptions, then passes an optimised prompt to Veo 3 for rendering. Best for complex narratives.

Note: Veo 3 is a preview model and may take up to 2–3 minutes to render. The response includes a status: pending initially, with the final URL returned when processing completes.
🎙️
Voice Studio NEW
AI text-to-speech with Google Cloud TTS and gTTS fallback

Voice Studio converts any text into professional audio using Google Cloud Text-to-Speech (premium neural voices) with gTTS as fallback when Cloud TTS is unavailable. Generated audio is saved to GCS and returned as a playable/downloadable URL.

1
Enter Your Script

Type or paste the text you want to convert — product descriptions, ad scripts, explainer narration, podcast intros, etc.

2
Select Language

Choose from English (US/UK), Spanish, French, German, Arabic, Urdu, Hindi, and more.

3
Choose Voice Type

Female — Professional, Male — Professional, Female — Friendly, Male — Friendly, Neutral.

4
Set Speed

Adjust the playback speed slider (0.5× to 2.0×). Default is 1.0×.

5
Generate & Download

Click Generate Voice. An audio player appears with play/pause controls and a direct download link to the MP3 file stored in GCS.

🔗
Social Account Hub NEW
Connect and manage all your social media accounts in one place

The Social Account Hub is your central dashboard for managing connected social media accounts across all supported platforms. Each account stores platform credentials, follower counts, and connection status — all scoped per project.

Supported Platforms

PlatformAccount TypesWhat's Stored
📸 InstagramBusiness / CreatorUsername, access token, followers, posts count
💼 LinkedInPersonal / Company PageUsername, token, connections count
📘 FacebookPage / GroupPage name, token, followers, page URL
🎵 TikTokBusinessUsername, token, followers, video count
▶️ YouTubeChannelChannel name, token, subscribers, videos
✖️ X (Twitter)Personal / BusinessHandle, token, followers, tweets
📌 PinterestBusinessUsername, token, followers, pins

Connecting an Account

1
Click "Connect" on the Platform Card

A modal opens with fields for: Platform Username, Access Token, Profile URL, and initial Followers Count.

2
Enter Credentials

Paste your platform access token (obtained from the platform's developer settings or OAuth flow).

3
View Setup Guide

Click Setup Guide on any platform card for step-by-step instructions on creating a developer app and getting your access token.

4
Sync Metrics

Use the Sync button to update follower counts and post statistics from the platform.

Tip: Access tokens are stored encrypted in BigQuery. Use the Disconnect button to revoke access and remove credentials at any time.
🏢
Company Profile NEW
Define your brand identity for AI context injection

The Company Profile page has 3 tabs: Company Info, Logo & Branding, and Social Handles. The information you enter here is automatically used as context in every AI generation request.

Company Info Tab

FieldPurposeUsed In
Company TaglineOne-liner brand promiseSocial posts, ad copy
Mission StatementWhy the company existsBlog articles, campaigns
VisionLong-term aspirational goalThought leadership content
Brand VoiceTone & personality descriptionAll AI generations
USPUnique Selling PropositionAd copy, email campaigns
Contact InfoEmail, phone, addressEmail footers, campaigns
📋
Standard Operating Procedures (SOPs) NEW
AI-generate and manage marketing SOPs for your team

SOPs live inside the Company Profile page. You can manually create SOPs or let Claude AI generate complete, detailed procedures from a category in seconds.

SOP Categories

📱 Social Media

Content approval workflow, posting schedule, engagement rules, crisis management protocol.

✍️ Content Creation

Ideation → writing → editing → SEO → approval → publishing pipeline.

💬 Customer Service

Response times, escalation paths, tone guidelines, complaint resolution steps.

🚀 Campaign Launch

Planning, creative brief, approvals, launch checklist, performance tracking.

🤝 Client Onboarding

Welcome sequence, account setup, kickoff meeting, first deliverables.

AI-Generate an SOP

1
Click "Generate with AI"

In the SOPs tab of Company Profile, click the Generate button.

2
Select Category

Choose from the 5 categories above.

3
Claude Generates

Claude Sonnet creates a detailed SOP with numbered steps, tools, and estimated durations for each step.

4
Review & Approve

Edit steps as needed, then click Approve to change status from Draft → Approved. Approved SOPs are visible to your team.

🖼️
Logo Creator NEW
AI-generate or upload your company and product logos

The Logo & Branding tab inside Company Profile lets you generate a logo using Imagen 3 or paste/upload an existing logo URL.

🤖 AI Generate Logo

Enter your brand name, industry, preferred style (Modern / Minimalist / Bold / Elegant / Playful), and color palette. Imagen 3 generates a professional, scalable vector-style logo in 1:1 format.

🔗 Upload Logo URL

Already have a logo? Paste the URL directly. Supports any publicly accessible image URL (PNG, SVG, JPG). The URL is saved to your company profile and auto-inserted into campaigns.

Logo Prompt Tips: The AI prompt is automatically constructed as "Professional logo for [Brand], [industry] company. [Style] style. Clean, minimal, scalable vector-style. No text. Color palette: [colors]." — specify colors for best brand consistency.
🚀
Campaign Wizard AI
End-to-end AI-assisted marketing campaign creation

The Campaign Wizard walks you through building a complete multi-channel marketing campaign in 6 steps, generating all assets (copy, images, subject lines, send schedule) automatically.

1
Campaign Goal

Choose: Brand Awareness, Lead Generation, Product Launch, Event Promotion, or Retention.

2
Target Audience

Define demographics, interests, and platform preferences.

3
Channel Selection

Pick: Email, Social (all platforms), Paid Ads, or a combination.

4
AI Generates Assets

One click generates all copy, subject lines, visuals (via Imagen 3), and a posting schedule.

5
Review & Edit

Edit any generated asset before publishing. Preview each piece in its platform context.

6
Publish or Schedule

Schedule posts to Content Calendar or trigger email sends directly from the wizard.

📧
Email Marketing NEW
AI-generated email campaigns with SendGrid delivery

📝 AI Subject Lines

Generate 5 subject line variants optimised for open rate, personalization tokens, and A/B testing.

📨 Template Builder

Drag-and-drop email builder with AI-generated body content, CTAs, and signature blocks.

👥 Audience Segments

Segment by plan type, engagement level, industry, or custom tags stored in BigQuery.

📊 Campaign Analytics

Track open rate, click rate, unsubscribes, and revenue attribution per campaign.

◆
Brand Intelligence AI
Competitive analysis, sentiment tracking, market positioning

🔍 Competitor Analysis

AI-powered analysis of competitor positioning, messaging, and content strategy based on publicly available data.

📈 Brand Sentiment

Track how your brand is perceived across social channels with sentiment scoring (0.0–1.0).

💡 Market Insights

Identify emerging trends, content gaps, and opportunities in your industry using AI analysis.

📌 Positioning Map

Visual map of your brand positioning vs competitors across key attributes.

💳
Billing & Usage Ledger NEW
Plans, usage tracking, per-generation cost ledger

Plans

PlanTextImagesVideosAudioCost Budget/moPrice
Free10515$0.10$0/mo
Starter100501050$3.00$29/mo
Pro50020050200$10.00$79/mo
Enterprise5,0002,0005002,000$40.00Custom

Usage Ledger NEW

Every AI generation is logged to the customer_billing_ledger BigQuery table with: resource type, AI engine used, quantity, unit cost, and total cost.

Cost Protection: The system enforces two limits before every generation: (1) Monthly count limits per plan, (2) Monthly cost budget per plan. If either is exceeded, the generation returns a 429 Quota Exceeded response.

Per-Resource Costs

ResourceUnit CostAI Engine
Text Generation$0.001Gemini 2.5 / Grok 3 / Claude
Image Generation$0.020Imagen 3 / Grok Aurora
Video Generation$0.100Veo 3
Audio (TTS)$0.005Google Cloud TTS / gTTS
Email Send$0.001SendGrid
⚡
API Reference
REST endpoints for all MarketingAI features

Base URL: https://marketingai-1075463475276.us-central1.run.app

Authentication: Authorization: Bearer <jwt_token>

AI Generation

POST/api/ai/text/social-postGenerate social media post (Gemini/Grok)
POST/api/ai/text/social-post-engineGenerate with explicit engine selection
POST/api/ai/image/generateGenerate image (Imagen 3 → Grok Aurora fallback)
POST/api/ai/video/generateGenerate video (Veo 3 or Grok+Veo)
POST/api/ai/audio/ttsText-to-speech (Cloud TTS → gTTS fallback)
GET/api/ai/debugCheck which AI engines are active

Social Accounts

GET/api/social/accountsList connected accounts (per project)
POST/api/social/accountsConnect / update an account
DEL/api/social/accounts/<id>Disconnect account
PUT/api/social/accounts/<id>/syncSync follower counts
GET/api/social/guide/<platform>Step-by-step connection guide

Company Profile & SOPs

GET/api/profileGet company profile
PUT/api/profileCreate / update company profile
POST/api/profile/logoAI-generate logo via Imagen 3
POST/api/profile/logo/uploadSave logo URL
GET/api/profile/sopsList SOPs for project
POST/api/profile/sopsCreate SOP manually
POST/api/profile/sops/generateAI-generate SOP via Claude
PUT/api/profile/sops/<id>Update SOP
DEL/api/profile/sops/<id>Archive SOP

Billing & Ledger

GET/api/payments/usageCurrent month usage counts
POST/api/payments/track-usageLog a generation event
GET/api/payments/ledger?month=YYYY-MMDetailed per-generation cost ledger
GET/api/payments/ledger/summaryMonthly cost totals (last 6 months)
⚠️
Quota & Limits
Per-plan generation limits and cost protections
Dual Protection System: Every AI generation is checked against TWO limits — (1) monthly count limit for your plan, AND (2) monthly cost budget for your plan. If either limit is reached, you receive a 429 Quota Exceeded response with the reason.

Frequently Asked Questions

What happens if Gemini is unavailable?

The system automatically falls back to Claude Sonnet (Anthropic API) for all text generation. This is transparent — you get the same response format.

What happens if Imagen 3 is unavailable?

Image generation automatically falls back to Grok Aurora (grok-2-image via xAI API). If Grok Aurora also fails, an error is returned with both error messages for diagnosis.

Where are generated images and audio stored?

All files are stored in Google Cloud Storage bucket gs://marketingai-assets/ and served via public URLs at https://storage.googleapis.com/marketingai-assets/...

Can I use my own API keys?

Enterprise plan users can contact support to configure their own Gemini, Anthropic, or xAI API keys for isolated usage tracking.

How do I get more quota?

Upgrade your plan in the Billing page. Plan upgrades take effect immediately.