> For the complete documentation index, see [llms.txt](https://docs.trendswap.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.trendswap.app/readme.md).

# README

Welcome to the official product documentation for **TrendSwap** ([trendswap.app](https://trendswap.app/)) — the high-speed viral social AI video studio engineered for motion transfer, character recasting, and portrait animation.

TrendSwap enables creators, influencers, meme producers, and everyday users to upload a single portrait photograph and instantly star in the internet's most iconic trending video scenes with complete identity fidelity and master scene audio.

***

## What is TrendSwap?

Internet video culture moves at lightning speed. When a scene goes viral on TikTok, Instagram Reels, or YouTube Shorts — such as Drake's candlelit *Burning Bridges* banquet walk, the frantic *Smalltown Boy* dual cat scream dance, or the iconic *Topo Gigio* soccer celebration — audiences everywhere want to participate in the meme.

Traditionally, recreating these viral clips required either:

1. Renting physical film sets, costumes, lighting equipment, and camera crews; or
2. Navigating deeply complex generative AI node trees (e.g., ComfyUI, custom checkpoints, LoRA training, complex negative prompt syntax, and frame interpolation models).

{% hint style="info" %}
**TrendSwap bridges this gap.** We turn multi-node generative video pipelines into streamlined, one-click template workflows. Users simply upload a front-facing portrait photo, select their target framing and resolution, and let TrendSwap's neural engine synthesize an authentic, high-definition, audio-synchronized MP4 ready for social media publishing.
{% endhint %}

***

## Core Capabilities & Technical Highlights

```
+-----------------------------------------------------------------------------------+
|                              TRENDSWAP STUDIO WORKFLOW                            |
+-----------------------------------------------------------------------------------+
|  [ User Portrait ]  -->  [ Automated Alignment ]  -->  [ Negative Conditioning ] |
|      (Image 1)                   (512px+)                 (No Actor Likeness)     |
|                                                                    |              |
|                                                                    v              |
|  [ Motion Reference ] -> [ Dynamic Camera Tracking ] -> [ Seedance 2.5 Neural Engine]
|      (Video 1)             (Handheld / Orbit / Zoom)               |              |
|                                                                    v              |
|  [ Master Soundtrack ] -> [ Beat / Vocal Sync ]       -> [ Watermark-Free MP4 ]   |
|   (Original Audio)            (Lip & Motion Match)         (480p / 720p / 1080p)  |
+-----------------------------------------------------------------------------------+
```

### 1. Absolute Identity Preservation & Anti-Morphing Protocol

Unlike legacy techniques that blend or average facial features with reference actors, TrendSwap enforces a strict **Identity Preservation Protocol**. The neural network inherits 100% of facial bone structure, eye contours, skin tone, nose bridge, and lip geometry from the user's uploaded portrait (`@Image 1`), while treating the reference video (`@Video 1`) purely as a choreography and lighting driver.

### 2. Native Master Soundtrack Integration

Every viral video template comes pre-baked with its signature master audio track (e.g., Dembow beats, Bronski Beat synth-pop, stadium crowd roar, Ye Sunday Service choir harmonies). Audio tracks are pre-synchronized to the video's motion choreography, delivering a ready-to-share MP4 with no manual audio editing required.

### 3. Dual Character Isolation & Role Alternation

For duo scenes such as *Smalltown Boy* or *Zombie Couple*, TrendSwap provides independent character slot mapping. Users can upload two distinct portraits (or swap roles between Lead and Partner), ensuring zero crosstalk, identity contamination, or role confusion between actors.

### 4. Zero-Watermark Commercial-Ready Exports

All generated video clips are delivered as clean, watermark-free MP4 files in either 9:16 vertical (optimized for TikTok, Reels, Shorts) or 16:9 widescreen format across 480p SD, 720p HD, and 1080p Full HD resolutions.

### 5. Transparent One-Time Credit Passes

TrendSwap operates on a customer-first, pay-as-you-go credit model:

* **No recurring subscriptions**: Users purchase one-time credit passes ($9.90, $24.90, $59.90).
* **Credits never expire**: Your balance remains active for lifetime usage.
* **Automated Credit Protection**: If upstream GPU rendering times out or fails safety inspection, credits are instantly refunded back to your account automatically.

### 6. Full Global Multi-Language Support

TrendSwap is fully localized across four major global languages:

* **English** (`en`)
* **Español** (`es`)
* **日本語** (`ja`)
* **简体中文** (`zh`)

Localization covers server-side rendered HTML, interactive studio controls, billing centers, order histories, and real-time generation progress logs.

***

## Documentation Structure

| Section                                                   | Description                                                                                           |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| [**Getting Started**](/quickstart.md)                     | Step-by-step walkthrough, photo recommendations, framing, and resolution options.                     |
| [**Core Engine**](/core-engine/seedance-architecture.md)  | Architectural deep dive into the Seedance 2.5 engine, Identity Preservation Protocol, and audio sync. |
| [**Templates Directory**](/templates/overview.md)         | Choreography breakdown, duration, required inputs, and lore for all 10 active viral templates.        |
| [**Pricing & Billing**](/pricing/passes-and-credits.md)   | Credit economics, package tiers, Stripe checkout security, and the Zero-Ticket Auto-Refund system.    |
| [**Internationalization**](/i18n/multilingual-support.md) | Multilingual architecture, SSR cookie detection, and global hreflang implementation.                  |
| [**Developer Integrations**](/integrations/mcp-server.md) | Model Context Protocol (MCP) server endpoints, Zapier automation workflows, and REST APIs.            |
| [**Trust & Ethics**](/trust/privacy-and-retention.md)     | Data minimization, 30-day auto-purge policy, likeness rights, and content moderation rules.           |
| [**FAQ**](/faq.md)                                        | Answers to frequently asked technical, billing, and creative questions.                               |

***

## Live Links & Resources

* **Official Studio**: [https://trendswap.app](https://trendswap.app/)
* **Official Documentation**: [https://docs.trendswap.app](https://docs.trendswap.app/)
* **GitHub Repository**: <https://github.com/GptsApp/trendswap>
* **Public MCP Server**: `https://trendswap.app/api/mcp`
* **Customer Support**: <support@trendswap.app>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.trendswap.app/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
