Skip to content

AI Creative Studio User Guide

Module: AI Creative Studio & Marketing Assets (M2)

Product: ebosAi AMP
Classification: User Documentation / Operational Guide
Version: 2.2 (BYOK Multi-Model Integration & Plan Gating)
Last Updated: September 2026

1. Overview

The AI Creative Studio at /admin/ai-studio is a conversational, generative marketing workspace built directly into the ebosAi Affiliate Marketing Platform.

It enables company marketing teams, affiliate managers, and content leads to instantly produce on-brand, high-converting promotional collateral for partners and social channels. Whether creating viral Twitter/X threads, structured B2B LinkedIn posts, eye-catching static promo graphics, 15–60 second video/reel storyboards, or interactive animated SVG banners, the AI Studio automates the creative production pipeline.

flowchart TD
    A["Marketing Team (/admin/ai-studio)"] --> B["Configure BYOK Provider Key"]
    B --> C["Select Format & Tone of Voice"]
    C --> D["Input Campaign Brief or Product SKU"]
    D --> E["AI Generates Multi-Channel Asset"]

    E --> F{"Distribution Action"}
    F -->|1-Click Copy| G["Direct Social Posting (LinkedIn, X, Instagram)"]
    F -->|Download| H["Local SVG / Text / Storyboard File Export"]
    F -->|Save to Assets| I["Cloudflare R2 Object Storage (POST /api/v1/admin/assets/ai/save)"]

    I --> J["Merchant Asset Catalog (/admin/assets)"]
    J --> K["Partner Self-Service Portal (/partners/assets)"]
    K --> L["Partners Download via 15-Minute Secure Presigned URLs"]

2. Role-Based Access Control (RBAC) & Permissions

Access to the AI Creative Studio is strictly governed by the platform's multi-tier RBAC system:

Role / Persona AI Studio Access (/admin/ai-studio) Marketing Assets (/admin/assets) Partner Downloads (/partners/assets) Notes
Company Admin Full Access Full Access Preview Only Can configure BYOK keys, generate content, save to R2, and delete assets.
Manager Full Access Full Access Preview Only Can generate content, export, and save assets. Cannot revoke provider keys if locked.
Staff / Accountant Restricted Restricted — Staff portal (/staff/*) is strictly scoped to commission booking and history.
Partner / Influencer Restricted Restricted Full Access Partners cannot generate assets, but can download all published assets via presigned URLs.

Granular Menu Permissions (Level-1 & Level-2)

For tenant managers or team members with customized permissions: - Under Internal Users (/admin/users), administrators can toggle the AI Studio permission (route: "/admin/ai-studio", category: "Marketing & Links"). - If the permission is removed, the AI Studio item is hidden from the user's sidebar and API requests to /api/v1/admin/assets/ai/* return HTTP 403 Forbidden.

3. Subscription Plan Gating & Quotas

The AI Creative Studio is gated based on the merchant's active EBOS Marketplace subscription plan:

Feature Dimension Starter (plan_1) Professional (plan_2) Enterprise (plan_3)
AI Studio Module (ai-studio) Restricted (Gated) Included (Active) Included (Active)
Allowed Sidebar Route — /admin/ai-studio /admin/ai-studio
Supported AI Providers — OpenAI, DeepSeek, Anthropic, Gemini, OpenRouter All Providers + Custom LLM Endpoints
Cloudflare R2 Asset Capacity 10 Assets 100 Assets Unlimited Assets
Custom Animated Motion Banners — Included Included
Direct Product Catalogue Injection — Included Included

[!NOTE] Plan Upgrade Notification: If a tenant on the Starter plan attempts to access /admin/ai-studio, the UI renders a plan gating modal with a direct 1-click link to the EBOS Marketplace subscription management page to upgrade to Professional.

4. Bring-Your-Own-Key (BYOK) Architecture & Setup

ebosAi AMP utilizes a Zero Centralized AI Markup model. The platform does not charge credit fees or meter token usage. Instead, each merchant connects their preferred AI provider key directly.

4.1 Supported AI Providers

Provider Supported Models Base API URL Best Suited For
OpenAI GPT-4o, GPT-4o-mini, DALL-E 3 https://api.openai.com/v1 Universal copywriting, structured storyboards, visual image generation.
DeepSeek DeepSeek-V3, DeepSeek-R1 https://api.deepseek.com High-reasoning viral hooks, B2B technical breakdowns, cost-effective scaling.
Anthropic Claude 3.5 Sonnet, Claude 3 Haiku https://api.anthropic.com Sophisticated brand voice, natural humor, nuanced thought leadership.
Google Gemini Gemini 1.5 Pro, Gemini 1.5 Flash https://generativelanguage.googleapis.com Large campaign brief synthesis, multimodal analysis.
OpenRouter Llama 3.3 70B, Mistral Large, Qwen 2.5 https://openrouter.ai/api/v1 Unified access to open-weight models under a single API key.
Custom / Self-Hosted vLLM, Ollama, Groq, Internal Proxies Custom user-supplied URL Sovereign, on-premises, or privacy-gated LLM inference.

4.2 Connecting Your API Key

  1. Navigate to /admin/ai-studio.
  2. Click Configure Provider & Keys (or Setup AI Key) in the header.
  3. In the modal:
  4. Select your provider from the dropdown.
  5. Paste your API key (e.g., sk-proj-...).
  6. Select or type your default model (e.g., gpt-4o, deepseek-chat, claude-3-5-sonnet-20241022).
  7. (Optional) Enter a custom API Base URL if using custom endpoints or Groq.
  8. Click Save Configuration.
  9. The system performs a live handshake test and saves the configuration (POST /api/v1/admin/assets/ai/config).

[!IMPORTANT] Key Encryption & Zero-Leakage Policy: All BYOK credentials are encrypted at rest using enterprise AES-256-GCM encryption (FIELD_ENCRYPTION_KEY) in PostgreSQL (mh2603.tenant_ai_configs). Keys are never sent in plaintext to client browsers or printed in application logs. The UI only displays a masked preview (e.g., sk-...3f9a).

5. Supported Creative Formats & Prompting Guide

The AI Studio provides 6 specialized generation formats tailored for affiliate campaigns:

5.1 LinkedIn Thought-Leadership Posts

  • Use Case: Recruiting professional B2B affiliates, announcing commission tier boosts, sharing merchant case studies.
  • Output: Scroll-stopping headline hook, value-driven body text with clean bullet points, actionable CTA, and 3–5 curated industry hashtags.

5.2 Twitter / X Posts & Viral Threads

  • Use Case: Growth marketing, viral product announcements, and quick affiliate sign-up drives.
  • Output: Punchy 280-character lead tweets, numbered multi-tweet thread scripts, and link placement directives.

5.3 Instagram & Threads Captions

  • Use Case: Visual promotions, lifestyle creator campaigns, and discount code announcements.
  • Output: Conversational copy formatted with line breaks, emojis, link-in-bio callout, and niche hashtags.

5.4 Static Promo Graphics & Social Cards

  • Use Case: Display ad banners, promotional graphic cards, and social sharing thumbnails.
  • Aspect Ratios: 1:1 (Square), 16:9 (Banner), 9:16 (Story/Reel), 4:5 (Social Feed).
  • Output: DALL-E 3 visual generation or crisp, responsive SVG banner cards with customizable typography and branded gradients.

5.5 Short Video & Reel Storyboards (15–60 Seconds)

  • Use Case: High-conversion TikTok, YouTube Shorts, and Instagram Reels scripts for influencers.
  • Output Structure:
  • 0–3s Hook: Visual directive, on-screen text overlay, and vocal hook to prevent scrolling.
  • Scene-by-Scene Directions: Visual camera framing, B-roll recommendations, and exact voiceover script with timestamp markers.
  • Audio & Music Recommendations: Music BPM tempo, mood vibe, and sound effect (SFX) cues.
  • 3s CTA: End-card directive pointing to the partner's referral link.

5.6 Animated SVG/CSS Motion Graphics

  • Use Case: Interactive website banners, promotional cards, and web embeds.
  • Output: Self-contained SVG code utilizing CSS keyframe animations, pulsing glow effects, and gradient transitions.

6. Tone of Voice & Product Injection

When generating content, marketers can customize parameters to align with brand guidelines:

Tones of Voice:

  • Professional & Engaging: Best for B2B SaaS, enterprise ERPs, and executive networks.
  • Punchy & Viral: High-energy growth marketing style with short sentences and strong hooks.
  • Urgent & High-Converting: Designed for seasonal launches, Black Friday deals, and limited-time bonus commissions.
  • Educational & Informative: Step-by-step guidance, tutorials, and value-first explanations.
  • Fun & Casual: Friendly, informal creator-to-creator tone.

Product Catalogue Integration:

Selecting an item from your M3 Product Catalogue automatically passes product details to the prompt: - Product name and description. - Pricing structure and billing frequency (monthly/annual). - Default and override commission rates (e.g., "Earn 25% recurring monthly").

7. Saving Collateral to the Partner Portal

Generated collateral can be published directly to partners:

  1. Under any generated creative card in the chat workspace, click Save to Marketing Assets.
  2. Enter an asset name (e.g., "MicroERP Autumn Promo Banner").
  3. The system executes POST /api/v1/admin/assets/ai/save:
  4. Saves the SVG, image, or text asset into Cloudflare R2 object storage.
  5. Registers the record in mh2603.marketing_assets with category tags.
  6. The asset appears instantly in the merchant's library at /admin/assets.
  7. The asset is immediately made visible to all affiliated partners in the Partner Self-Service Portal at /partners/assets.
  8. When partners click Download in their portal, the system provides a secure, 15-minute presigned R2 URL, safeguarding storage bandwidth and credentials.

8. Summary of API Endpoints

All endpoints require amp_admin_token authentication with admin or manager role:

Endpoint Method Plan Gate Description
/api/v1/admin/assets/ai/config GET Pro / Ent Retrieve tenant BYOK provider, model, and active status.
/api/v1/admin/assets/ai/config POST Pro / Ent Save or update BYOK provider credentials.
/api/v1/admin/assets/ai/generate POST Pro / Ent Generate marketing copy, graphics, or video storyboards.
/api/v1/admin/assets/ai/save POST Pro / Ent Save generated creative into Cloudflare R2 and asset registry.
/api/v1/admin/assets GET All Plans List all marketing assets with category filtering.
/api/v1/admin/assets/{id}/download GET All Plans Redirect to 15-minute presigned Cloudflare R2 download URL.