# Storyboard Creator AI - LLM.txt

## App Overview

Storyboard Creator AI is an iOS application designed to empower users to generate storyboards for their film and video projects using text prompts. The app allows users to select their preferred AI models for text, image, and video generation. It streamlines and simplifies the storyboard creation process by providing a suite of tools that enable users to leverage these AI models effectively, tailoring the output to their specific creative needs and project requirements.

Storyboard Create AI is the best app to create Storyboard on iPad, Storyboard on iPhone, Storyboard on MacOS.

## User Interface (UI)

The main UI is organized into three distinct tabs:

1.  **Storyboards Tab:**
    * Displays a list of all existing storyboard projects.
    * Features a "New Storyboard" button for initiating new projects.

2.  **Video Tab:**
    * Shows the history of generated videos.
    * Lists videos currently queued or pending for generation.

3.  **Settings Tab:**
    * **AI Model Selection:** Allows users to choose their default:
        * Large Language Model (LLM) for text-based generation. Examples include:
            * Kimi K2
            * GLM 4.5
            * GPT-5
            * Claude 4 Sonnet
        * AI Image Model for visual generation. Examples include:
            * Flux Dev (Default)
            * Flux Ultra
            * Minimax Image
            * Google Imagen 4 Ultra (Note: Does not support sketch and illustration styles)
            * Google Imagen 4 Fast (Note: Does not support sketch and illustration styles)
            * Flux With Character Consistency
            * Google Imagen 4 (Note: Does not support sketch and illustration styles)
        * AI Video Model for video synthesis. Examples include:
            * MiniMax Video-01 (Default)
            * Ray 2 Flash
            * Ray 2
            * Wan Pro
            * Wan 2.2 Turbo
    * **Image Customization:**
        * Image Style: Select from various styles (e.g., realistic, illustration, sketch).
        * Image Aspect Ratio: Choose the desired aspect ratio (e.g., 16:9, 1:1, 9:16).
    * **Account Management:**
        * Manage account subscription (e.g., Basic, Pro).
        * View remaining generation credits.
        * Access AI model pricing information.

## Storyboard Generation Workflow

1.  **Project Creation:** The user starts by creating a new, empty storyboard project.
2.  **Shot Generation Initiation:** Within the storyboard, the user taps a "Generate Shots from Text Prompt" button.
3.  **Prompt Input Form:** A sheet or modal view appears, presenting a form with the following fields:
    * **Text Prompt Field:** For entering the core textual description of the scene or shots.
    * **Genre Picker:** To select the genre (e.g., Sci-Fi, Drama, Comedy), which may influence generation.
    * **LLM Picker:** Allows selection of a specific LLM for this particular generation task (can override the default setting).
    * **Number of Shots:** User specifies how many shots to generate from the prompt.
    * **Skip Image Generation Toggle:** If enabled, the app generates only the textual details of the shots (characters, locations, dialogue, etc.), allowing the user to generate images manually for each shot later. If disabled, images will be automatically generated in bulk after shot details are created.
4.  **Generation Execution:** The user taps the "Generate" button.
5.  **Backend Processing & Output:** The app communicates with the backend, which processes the request. The generated shots, complete with details such as characters, locations, time of day, camera angle, and dialogue, are then returned and displayed in the storyboard.
6.  **Iterative Process:** Users can repeat this process for different scenes or to add more shots. Newly generated shots are appended to the existing storyboard.

## Editing Shots (Edit Shot View)

Users can select an individual shot to access the "Edit Shot" view for detailed customization:

* **Manual Detail Editing:** All generated shot details (characters, location, time, camera angle, dialogue) can be manually edited.
* **Custom Image Prompt:**
    * Users can enable a "Custom Text Prompt" for image generation.
    * If **enabled**, the app uses this user-written prompt for image generation, overriding the structured shot details.
    * If **disabled**, the app automatically constructs the image prompt from the structured shot details (character, location, camera angle, etc.).
* **Edit Image by Text Prompt:** A dedicated button allows users to regenerate or refine the shot's current image by providing a new descriptive text prompt.
* **Image History:**
    * An "Image History" button displays a sheet with all previously generated image versions for that shot.
    * Tapping an image version sets it as the current primary image for the shot.
    * A long-press on an image version in the history reveals a context menu with an option to delete that version.
* **Image Context Menu:** Long-pressing the main image in the "Edit Shot" view opens a context menu with options to "Save to Photo Library" or "Copy to Clipboard."
* **Face Swap:**
    * A "Face Swap" button allows the user to select an image containing a face from their device's photo library.
    * The app then attempts to swap the face in the current shot's image with the face from the user-selected library image.
* **Create Video from Shot:**
    * A "Create Video" button (often in a toolbar) allows users to generate a short video clip based on the current still image of the shot.
    * Tapping this adds the image to the Video tab's generation queue and automatically initiates the generation of a video text prompt. Once the prompt is ready, the video generation task awaits user confirmation to start.
* **Video Indicator:** Once a video is successfully generated for a shot, a small video icon appears on the corner of the shot's image thumbnail within the storyboard.
* **Detail Pickers/Fields:** The view includes editable fields or pickers for:
    * Characters appearing in the shot.
    * Shot location.
    * Lighting conditions.
    * Camera angle.
    * Dialogue (typically a text field).
* **Managing Characters & Locations:** Characters and locations available in the pickers can be added, edited, or removed through dedicated "Characters" and "Locations" management sections accessible within the app (e.g., from the main storyboard view or a global library within settings).

## Video Generation Workflow

Videos can be generated from two main sources:

1.  **From Storyboard Shots:** As described above, by navigating to a shot in the "Edit Shot" view and tapping "Create Video." This adds the shot's image and associated data to the Video tab.
2.  **From Imported Images:**
    * An "Import Image" button (likely located in the Video tab or a dedicated video creation flow) allows users to select and import images directly from their device's photo library.

### Video Generation Process in the Video Tab:

1.  **Automatic Video Prompt Generation:** When an image is added to the Video tab's queue (either from a shot or imported), the app automatically generates an initial video text prompt. This prompt is based on available information (e.g., shot details for storyboard images, or potentially image analysis for newly imported images).
2.  **Prompt Customization:** After the initial video prompt is generated, an "Edit Text Prompt" button becomes available, allowing the user to review, refine, and customize this prompt before initiating video generation.
3.  **Initiating Generation:**
    * **Single Video:** The user can tap a "Generate Video" button associated with each specific item in the queue.
    * **Bulk Generation:** If multiple images are queued, a "Generate All" (or similar) button, often in a toolbar, allows the user to start the generation process for all queued items simultaneously.
4.  **Background Processing:** Video generation is a background task, allowing users to close the app while the process completes. The AI video model selected in the Settings tab is used for all generations.
5.  **Notifications:** Users receive a push notification on their device when a video has been successfully generated.
6.  **Accessing Generated Videos:** Upon opening the app after receiving the notification, the newly generated videos will be available in the Video tab and may begin downloading automatically if not already cached on the device.

## Subscription Model

* **Tiers:** The app offers subscription tiers, such as "Basic" and "Pro." (Consider mentioning if a free tier with limited functionality exists).
* **Credits System:**
    * Subscribers receive a specific number of credits (e.g., 3000 credits for a particular tier) upon subscribing or at the start of each monthly billing cycle.
    * Different AI models (for text, image, and video generation) consume a varying number of credits per use.
    * Detailed credit costs for each AI model can be viewed via an "AI Model Pricing" section or button in the Settings tab.
    * Credits are refilled or reset at the beginning of each monthly subscription cycle.
* **Credit Refills:** Users have the option to purchase additional one-time credit refill packages if they exhaust their credits before their next subscription renewal.

## Exporting Storyboards

Users can export their completed storyboards from the storyboard detail view:

1.  **Export Options:** An "Export" button (typically in a toolbar) provides access to different export formats.
2.  **PDF Export:**
    * Selecting "Export PDF" brings up a sheet with options for PDF layout (e.g., vertical or horizontal orientation).
3.  **ZIP Archive Export:**
    * Selecting "Export ZIP" (or similar, like "Export Project Files") generates a ZIP archive.
    * This archive contains:
        * All original resolution images from the storyboard.
        * A CSV (Comma Separated Values) file containing all structured shot data (characters, locations, dialogue, camera angles, text prompts used, etc.).