# Enums and Descriptions

## Enum Definitions and JSON Representation

This document provides a comprehensive explanation of the enums used in the AdCreative API. These enums are essential for understanding the JSON requests and responses, enabling developers to use the correct values.

***

### 1. `RenderKind`

The `RenderKind` enum specifies the dimensions of the output renders. Each value corresponds to a specific size or group of sizes.

#### Definition

```json
{
    "Unset": 0,
    "Post": 1,
    "Story": 2,
    "Landscape": 4,
    "Vertical": 8,
    "PinSize": 16,
    "Social": 31,
    "MediumBanner": 32,
    "LeaderBoard": 64,
    "WideSkyScraper": 128,
    "HalfPage": 256,
    "LargeLeaderboard": 512,
    "FullHD": 1024,
    "Portrait": 2048,
    "Widescreen": 4096,
    "VideoPortrait": 8192,
    "VideoLandscape": 16384,
    "Display": 992,
    "All": 1023
}
```

#### Description

<table><thead><tr><th width="217">Value</th><th width="316">Description</th><th>Dimensions</th></tr></thead><tbody><tr><td><code>Unset</code></td><td>No rendering type set.</td><td>N/A</td></tr><tr><td><code>Post</code></td><td>Square post size.</td><td>1080x1080 px</td></tr><tr><td><code>Story</code></td><td>Vertical story size.</td><td>1080x1920 px</td></tr><tr><td><code>Landscape</code></td><td>Landscape size for banners.</td><td>1200x628 px</td></tr><tr><td><code>Vertical</code></td><td>Vertical size for portrait ads.</td><td>1080x1350 px</td></tr><tr><td><code>PinSize</code></td><td>Pinterest-specific size.</td><td>1000x1500 px</td></tr><tr><td><code>Social</code></td><td>Combination of all social sizes.</td><td>Multiple sizes</td></tr><tr><td><code>MediumBanner</code></td><td>Medium rectangle banner.</td><td>300x250 px</td></tr><tr><td><code>LeaderBoard</code></td><td>Large horizontal banner.</td><td>728x90 px</td></tr><tr><td><code>WideSkyScraper</code></td><td>Tall vertical banner.</td><td>160x600 px</td></tr><tr><td><code>HalfPage</code></td><td>Large vertical half-page banner.</td><td>300x600 px</td></tr><tr><td><code>LargeLeaderboard</code></td><td>Large leaderboard banner.</td><td>970x90 px</td></tr><tr><td><code>FullHD</code></td><td>Full HD resolution.</td><td>1920x1080 px</td></tr><tr><td><code>Portrait</code></td><td>Portrait resolution.</td><td>768x1024 px</td></tr><tr><td><code>Widescreen</code></td><td>Widescreen resolution.</td><td>1024x768 px</td></tr><tr><td><code>VideoPortrait</code></td><td>Portrait-oriented video resolution.</td><td>768x1280 px</td></tr><tr><td><code>VideoLandscape</code></td><td>Landscape-oriented video resolution.</td><td>1280x768 px</td></tr><tr><td><code>Display</code></td><td>Combination of display ad sizes.</td><td>Multiple sizes</td></tr><tr><td><code>All</code></td><td>All possible sizes.</td><td>Multiple sizes</td></tr></tbody></table>

***

### 2. `RenderType`

The `RenderType` enum specifies the type of output render.

#### Definition

```json
{
    "Unset": 0,
    "Html": 1,
    "Svg": 2,
    "AiProduct": 4,
    "AiImageUpscaling": 8,
    "AiProductCreative": 16,
    "AiImageGeneration": 32,
    "AiSampledImageGeneration": 64,
    "AiFaceEnhancing": 128,
    "AiInPainting": 1024,
    "AiOutPainting": 127,
    "AiDressing": 256,
    "AiDetailEnhancing": 512,
    "TemplateBased": 19,
    "AiGenerationBased": 100,
    "All": 127
}
```

#### Description

| Value                      | Description                                 |
| -------------------------- | ------------------------------------------- |
| `Unset`                    | No render type set.                         |
| `Html`                     | HTML-based render (deprecated).             |
| `Svg`                      | SVG format render.                          |
| `AiProduct`                | AI-generated product images.                |
| `AiImageUpscaling`         | AI-based image upscaling.                   |
| `AiProductCreative`        | AI-generated product creatives.             |
| `AiImageGeneration`        | AI-based image generation.                  |
| `AiSampledImageGeneration` | AI image generation using a sample.         |
| `AiFaceEnhancing`          | AI-based facial detail enhancement.         |
| `AiInPainting`             | AI-based in-painting for image restoration. |
| `AiOutPainting`            | AI-based out-painting for extending images. |
| `AiDressing`               | AI dressing of models.                      |
| `AiDetailEnhancing`        | AI-based detail enhancement.                |
| `TemplateBased`            | Template-based rendering types.             |
| `AiGenerationBased`        | AI generation-related rendering types.      |
| `All`                      | All rendering types.                        |

***

### 3. `RenderState`

The `RenderState` enum describes the state of a rendering process.

#### Definition

```json
{
    "NotStarted": 0,
    "Started": 1,
    "Scheduled": 2,
    "Cancelled": 3,
    "Failed": 4,
    "Succeeded": 5,
    "Default": 0
}
```

#### Description

| Value        | Description                                     |
| ------------ | ----------------------------------------------- |
| `NotStarted` | The render process has not started.             |
| `Started`    | The render process has started.                 |
| `Scheduled`  | The render process is scheduled.                |
| `Cancelled`  | The render process was cancelled.               |
| `Failed`     | The render process failed.                      |
| `Succeeded`  | The render process succeeded.                   |
| `Default`    | The default state (equivalent to `NotStarted`). |

***

### 4. `NotificationChannel`

The `NotificationChannel` enum specifies the channel for notifications.

#### Definition

```json
{
    "WebHook": 0,
    "SignalR": 1,
    "RabbitMQ": 2
}
```

#### Description

| Value      | Description                          |
| ---------- | ------------------------------------ |
| `WebHook`  | Notifications are sent via WebHook.  |
| `SignalR`  | Notifications are sent via SignalR.  |
| `RabbitMQ` | Notifications are sent via RabbitMQ. |

***

### 5. `ImageStyle`

The `ImageStyle` enum specifies various styles for generating stock images. Each value represents a unique style, providing users with diverse options for image creation. Below is the detailed documentation for each enum value, including its purpose and description.

***

### Definition

```json
{
    "Unset": 0,
    "CustomWithText": 1,
    "CustomWithImage": 2,
    "Photorealistic": 3,
    "StudioShot": 4,
    "ThreeDRender": 5,
    "HighlyDetailed": 6,
    "Fantasy": 7,
    "Cinematic": 8,
    "Cyberpunk": 9,
    "DigitalPainting": 10,
    "IsometricArt": 11,
    "Surrealism": 12
}
```

***

### Enum Values

<table><thead><tr><th width="234">Name</th><th width="85">Value</th><th>Description</th></tr></thead><tbody><tr><td><code>Unset</code></td><td>0</td><td>The image style is unset. This is the default value.</td></tr><tr><td><code>CustomWithText</code></td><td>1</td><td>Custom image style with added text elements.</td></tr><tr><td><code>CustomWithImage</code></td><td>2</td><td>The style is derived from a custom image provided by the user.</td></tr><tr><td><code>Photorealistic</code></td><td>3</td><td>Stock images with lifelike precision and detail.</td></tr><tr><td><code>StudioShot</code></td><td>4</td><td>Clean, focused images with soft, professional lighting.</td></tr><tr><td><code>ThreeDRender</code></td><td>5</td><td>3D-rendered images with realistic depth and polished textures.</td></tr><tr><td><code>HighlyDetailed</code></td><td>6</td><td>Highly detailed images with intricate textures and sharp definition.</td></tr><tr><td><code>Fantasy</code></td><td>7</td><td>Mystical and enchanting visuals with a touch of magic.</td></tr><tr><td><code>Cinematic</code></td><td>8</td><td>Dramatic lighting and intense shadows for a filmic look.</td></tr><tr><td><code>Cyberpunk</code></td><td>9</td><td>Futuristic style with neon highlights and high-tech aesthetics.</td></tr><tr><td><code>DigitalPainting</code></td><td>10</td><td>Artistically crafted visuals with bold colors and soft strokes.</td></tr><tr><td><code>IsometricArt</code></td><td>11</td><td>Precise, structured visuals with a three-dimensional perspective.</td></tr><tr><td><code>Surrealism</code></td><td>12</td><td>Dreamlike scenes with abstract, otherworldly elements.</td></tr></tbody></table>

***

### Usage Examples

#### Example 1: Setting Image Style

```csharp
var imageStyle = ImageStyle.Photorealistic;
Console.WriteLine($"Selected image style: {imageStyle}");
```

#### Example 2: Conditional Logic with Image Styles

```csharp
switch (imageStyle)
{
    case ImageStyle.Cyberpunk:
        Console.WriteLine("Creating a futuristic cyberpunk-themed image...");
        break;
    case ImageStyle.Fantasy:
        Console.WriteLine("Generating a magical fantasy-themed image...");
        break;
    default:
        Console.WriteLine("Using default image style.");
        break;
}
```

***

### Additional Notes

* The `Unset` value serves as a placeholder and should be avoided in production scenarios.
* `CustomWithText` and `CustomWithImage` allow user-provided inputs to influence the image style.
* Styles like `Photorealistic` and `StudioShot` are ideal for realistic and professional visuals, while `Fantasy` and `Cyberpunk` cater to creative and futuristic designs.

### 6. `AdTextType`

The `AdTextType` enum specifies various ad text styles and methodologies used for generating high-conversion ad copy. Each value corresponds to a specific ad text framework or principle, providing detailed examples and explanations.

### Definition

```json
{
    "Unknown": 0,
    "SharpTechnique": 1,
    "GateFramework": 2,
    "LiftMethod": 3,
    "PasFormula": 4,
    "BabFormula": 5,
    "FabFormula": 6,
    "AidaModel": 7,
    "FourCSPrinciple": 8,
    "FourUSPrinciple": 9,
    "SlapMethod": 10,
    "QuestMethod": 11,
    "AccaModel": 12,
    "KissPrinciple": 13,
    "MetaPackage": 14,
    "GooglePackage": 15,
    "OAthFormula": 16,
    "PPPPFormula": 17,
    "PaisFormula": 18,
    "AppFormula": 19,
    "SuccessMethod": 20,
    "Headline": 21,
    "ShortHeadline": 22,
    "LongHeadline": 23,
    "GoogleResponsiveSearchAds": 24,
    "GoogleResponsiveDisplayAds": 25,
    "LinkedInSingleImageVideoAds": 26,
    "LinkedInTextAds": 27,
    "BingSearchAds": 28,
    "BingDisplayAds": 29,
    "PowerPack": 30,
    "Description": 31,
    "AiRenderProductVideoFromImageChat": 32,
    "AiProductImageAndVideoRecommendationChat": 33,
    "AiProductVideoPromptRecommendationsChat": 34,
    "AiProductVideoPromptOptimizerChat": 35,
    "ProductPhotoShootImageDescription": 36,
    "ProductPhotoShootRecommendationForVideo": 37,
    "ProductPhotoShootOptimizerForVideo": 38,
    "BuyerPersona": 39
}
```

***

## AdTextType Enum Description Table

<table data-full-width="true"><thead><tr><th width="280">Value</th><th>Description</th></tr></thead><tbody><tr><td><code>Unknown</code></td><td>Unknown text type.</td></tr><tr><td><code>SharpTechnique</code></td><td><p><strong>SHARP Technique: Short Headlines for Ads.</strong><br>Examples:</p><ul><li>Improve your child’s grades with Learning Room!</li><li>Get ahead of the competition with Learning Room!</li><li>Give your child the tools they need to succeed with Learning Room!</li><li>Help your child reach their full potential with Learning Room!</li></ul></td></tr><tr><td><code>GateFramework</code></td><td><strong>GATE Framework: General Ad Texts.</strong><br>Examples: <strong>Are you ready for a whiter, healthier smile in as little as 9 minutes per day? Our Snow Teeth Whitening Kit helps brighten teeth, remove coffee and wine stains, and doesn’t cause pain. With more than 600,000 customers who are extremely satisfied with the results, we’re sure you’ll love our at home teeth whitening kit too.</strong> Buy your kit today for immediate results!</td></tr><tr><td><code>LiftMethod</code></td><td><strong>LIFT Method: Listicle Style Ad Texts.</strong><br>Examples: <strong>At-Home Teeth Whitening Made Easy</strong><br><strong>Ad: We turn yellow and stained teeth into pearly whites in just 9-minutes a day.</strong><br><strong>😁 The World’s #1 Teeth Whitening System</strong><br><strong>⭐️ Loved by 600,000+ Happy Customers</strong><br><strong>✅ Featured in GQ, Elle, Vogue &#x26; Forbes</strong><br><strong>Get your Snow Teeth Whitening Kit today, receive 50% discount!</strong></td></tr><tr><td><code>PasFormula</code></td><td><strong>PAS Formula: Pain-Agitate-Solution Style Ad Texts.</strong><br>Pain: While you should get your teeth professionally cleaned twice a year, it’s not exactly realistic when you’re busy with work and personal commitments. Agitate: Our whitening kit removes 99% of stains within 14 days — without the pain. Solution: Whiten your teeth in minutes per day with our DIY teeth whitener solution designed for sensitive teeth and gums.</td></tr><tr><td><code>BabFormula</code></td><td><strong>BAB Formula: Before-After-Bridge Style Ad Texts.</strong><br>Examples: Before: Writing blog posts and landing pages for your clients can be a tedious task. After: ContentBot, an AI-powered copywriting assistant makes it easy. Bridge: Automate your marketing efforts and save time!</td></tr><tr><td><code>FabFormula</code></td><td><strong>FAB Formula: Feature-Advantage-Benefit Style Ad Texts.</strong><br>Features: Specially designed for making froth milk and delicious coffee. Advantages: Simple one-touch operation. Benefits: Enjoy delicious coffee with family and friends.</td></tr><tr><td><code>AidaModel</code></td><td><strong>AIDA Model: Attention, Interest, Desire, Action.</strong><br>Examples: Attention: Get a Dazzling Smile in Just 7 Days! Interest: Tired of hiding your yellow teeth? Desire: Advanced whitening technology removes stains. Action: Order now for a confident smile!</td></tr><tr><td><code>FourCSPrinciple</code></td><td><strong>4C’s Principle: Clear, Concise, Compelling, Credible.</strong><br>Examples: Clear: Whiten your teeth up to 8 shades in just 7 days. Concise: Try our enamel-safe tooth whitening gel. Compelling: Join thousands of radiant smiles! Credible: Trusted by leading dentists.</td></tr><tr><td><code>FourUSPrinciple</code></td><td><strong>4U’s Principle: Urgent, Unique, Ultra-specific, Useful.</strong><br>Examples: Urgent: Limited-time offer: Save 25%! Unique: Exclusive, patented whitening formula. Ultra-specific: Dentist-approved, results in just 7 days. Useful: Enjoy a whiter smile without hassle.</td></tr><tr><td><code>SlapMethod</code></td><td><strong>SLAP Method: Stop, Look, Act, Purchase.</strong><br>Examples: Stop: New Breakthrough: Dazzling Smiles in 7 Days! Look: Discover SmileBright, the revolutionary tooth whitening solution. Act: Ready to embrace a brilliant smile? Order now! Purchase: Buy one, get one 50% off!</td></tr><tr><td><code>QuestMethod</code></td><td><strong>QUEST Method: Qualify, Understand, Educate, Stimulate, Transition.</strong><br>Examples: Qualify: Looking for a fast way to brighten your smile? Understand: Self-conscious about yellow teeth? Educate: SmileBright delivers visible results in just 7 days. Stimulate: Imagine the confidence of a radiant smile. Transition: Order SmileBright today!</td></tr><tr><td><code>AccaModel</code></td><td><strong>ACCA Model: Awareness, Comprehension, Conviction, Action.</strong><br>Examples: Awareness: Introducing SmileBright. Comprehension: Dentist-approved formula removes stains. Conviction: Trusted by thousands for brilliant smiles. Action: Order SmileBright now!</td></tr><tr><td><code>KissPrinciple</code></td><td><strong>KISS Principle: Keep It Simple and Straightforward.</strong><br>Examples: Simple: Whiten your teeth quickly. Straightforward: Removes stubborn stains in 7 days. Call to Action: Order SmileBright today!</td></tr><tr><td><code>MetaPackage</code></td><td><strong>Meta Package: Dynamic Creative Ads.</strong><br>Examples: Meta Dynamic Creative Ads require 5 Primary Texts and 5 Headlines. Generates multiple sets using proven copywriting frameworks.</td></tr><tr><td><code>GooglePackage</code></td><td><strong>Google Package: Performance Max Ads.</strong><br>Examples: Requires 5 Headlines, 5 Long Headlines, and 5 Descriptions. Generated with high-conversion-rate methodologies.</td></tr><tr><td><code>OAthFormula</code></td><td><strong>OATH Formula: Old-Annoyed-Thorough-Hesitant Style Ad Texts.</strong><br>Examples: Self-conscious about stained teeth? Frustrated that brushing doesn’t work? Our revolutionary whitening product ensures visibly whiter teeth in just 2 weeks!</td></tr><tr><td><code>PPPPFormula</code></td><td><strong>PPPP Formula: Picture-Promise-Prove-Push Style Ad Texts.</strong><br>Examples: Picture yourself with a radiant smile. Promise: Remove years of stains. Prove: Testimonials and before-and-after photos. Push: Start smiling with confidence!</td></tr><tr><td><code>PaisFormula</code></td><td><strong>PAIS Formula: Problem-Agitate-Invalidate-Solve Style Ad Texts.</strong><br>Examples: Problem: Struggling with teeth stains? Agitate: Lack of potency in over-the-counter solutions. Invalidate: Whitening toothpaste isn’t enough. Solve: Our product guarantees results in just 2 weeks.</td></tr><tr><td><code>AppFormula</code></td><td><strong>APP Formula: Agree-Promise-Preview Style Ad Texts.</strong><br>Examples: Agree: A bright smile boosts confidence. Promise: Removes deep-set stains. Preview: Efficient and easy-to-use whitening solution.</td></tr><tr><td><code>SuccessMethod</code></td><td><strong>SUCCESs Method: Simple-Unexpected-Concrete-Credible-Emotional-Story Style Ad Texts.</strong><br>Examples: Simple: Whiten your teeth easily. Unexpected: Immediate visible effects. Credible: Trusted by dentists. Emotional: Joy of transformation. Story: A brighter smile starts here.</td></tr><tr><td><code>Headline</code></td><td>Headline text type.</td></tr><tr><td><code>ShortHeadline</code></td><td>Short Headline text type.</td></tr><tr><td><code>LongHeadline</code></td><td>Long Headline text type.</td></tr><tr><td><p><code>GoogleResponsive</code></p><p><code>SearchAds</code></p></td><td><strong>Google Package: Responsive Search Ads.</strong><br>Examples: 15 Headlines (30 characters) and 4 Descriptions (90 characters) required. High conversion rates achieved through tested methodologies.</td></tr><tr><td><p><code>GoogleResponsive</code></p><p><code>DisplayAds</code></p></td><td><strong>Google Package: Responsive Display Ads.</strong><br>Examples: 5 Headlines (30 characters), 1 Long Headline (90 characters), and 5 Descriptions (90 characters). Consistently high conversion rates.</td></tr><tr><td><p><code>LinkedInSingle</code></p><p><code>ImageVideoAds</code></p></td><td><strong>LinkedIn Package: Single Image/Video Ads.</strong><br>Examples: Requires 1 headline (up to 100 characters) and 1 description (up to 600 characters). More than 10 texts generated.</td></tr><tr><td><code>LinkedInTextAds</code></td><td><strong>LinkedIn Package: Text Ads.</strong><br>Examples: Requires 1 headline (up to 25 characters) and 1 description (up to 75 characters). Generates over 10 options.</td></tr><tr><td><code>BingSearchAds</code></td><td><strong>Bing Ads Package: Search Ads.</strong><br>Examples: 15 Headlines (30 characters) and 4 Descriptions (90 characters) required. Optimized for high conversion rates.</td></tr><tr><td><code>BingDisplayAds</code></td><td><strong>Bing Ads Package: Audience Display Ads.</strong><br>Examples: Requires 15 Short Headlines, 5 Long Headlines, and 5 Ad Texts.</td></tr><tr><td><code>PowerPack</code></td><td><strong>Power Pack: All-in-one Ad Text Package.</strong><br>Examples: Generates over 20 conversion-focused ad texts using all powerful copywriting techniques at AdCreative.ai.</td></tr><tr><td><code>Description</code></td><td>Description text type.</td></tr><tr><td><p><code>AiRenderProduct</code></p><p><code>VideoFromImageChat</code></p></td><td>AI Render Product Video From Image Chat text type.</td></tr><tr><td><p><code>AiProductImageAndVideo</code></p><p><code>RecommendationChat</code></p></td><td>AI Product Image And Video Recommendation Chat text type.</td></tr><tr><td><p><code>AiProductVideoPrompt</code></p><p><code>RecommendationsChat</code></p></td><td>AI Product Video Prompt Recommendations Chat text type.</td></tr><tr><td><p><code>AiProductVideoPrompt</code></p><p><code>OptimizerChat</code></p></td><td>AI Product Video Prompt Optimizer Chat text type.</td></tr><tr><td><p><code>ProductPhotoShootImage</code></p><p><code>Description</code></p></td><td>Product Photo Shoot Image Description text type.</td></tr><tr><td><p><code>ProductPhotoShoot</code></p><p><code>RecommendationForVideo</code></p></td><td>Product Photo Shoot Recommendation For Video text type.</td></tr><tr><td><p><code>ProductPhotoShoot</code></p><p><code>OptimizerForVideo</code></p></td><td>Product Photo Shoot Optimizer For Video text type.</td></tr><tr><td><code>BuyerPersona</code></td><td>Buyer Persona text type.</td></tr></tbody></table>

***

### 6. `AdTextTones`

#### AdTextTones Enum - JSON Format and Usage Guide

The **AdTextTones** enum represents the tone of the generated text output in the API. Each tone is provided as a descriptive string value to ensure clarity and ease of use. Below is the JSON representation of the enum, followed by an explanation for implementing it in your API requests.

***

**JSON Representation**

```json
{
  "AdTextTones": [
    "Professional",
    "Informal",
    "Friendly",
    "Enthusiastic",
    "Humorous",
    "Inspirational",
    "Persuasive",
    "Luxurious",
    "Conversational",
    "Educational",
    "Emotional",
    "Authoritative",
    "Nostalgic",
    "Romantic",
    "Playful",
    "Sarcastic",
    "Urgent",
    "Empathetic",
    "Uplifting",
    "Minimalist"
  ]
}
```

***

**Explanation**

* **Purpose:**\
  The `AdTextTones` enum defines the tone of the text content generated by the API. Developers can choose the desired tone by passing its string value (e.g., `"Friendly"`, `"Professional"`) in the relevant API request.
* **Data Type:**\
  The tone values are provided as strings to ensure compatibility and readability in API integrations.
* **Example Use Case:**\
  When creating a text generation request, the tone can be specified in the payload to align the generated content with the desired communication style.

***

**Example Request Payload**

Below is an example of how to include a tone selection in your API request:

```json
{
  "projectName": "Marketing Campaign 2025",
  "contentType": "Ad Copy",
  "tone": "Inspirational",
  "keywords": ["innovative", "sustainable", "future-focused"],
  "targetAudience": "Tech Enthusiasts"
}
```

* **Field Descriptions:**
  * `projectName`: The name of the project for reference.
  * `contentType`: The type of content you are generating.
  * `tone`: The selected tone for the text generation, chosen from the `AdTextTones` enum.
  * `keywords`: Keywords to focus on in the generated text.
  * `targetAudience`: The audience the text is aimed at.

***

**Notes**

* Ensure that the `tone` field in your API payload contains one of the valid values from the `AdTextTones` enum.
* If no tone is specified, the API may default to a neutral tone (e.g., `"Professional"`).

This structured approach allows developers to produce content that matches the desired tone and ensures consistent integration with the API.

## AdTextTones Enum Description Table

<table><thead><tr><th width="209">Value</th><th>Description</th></tr></thead><tbody><tr><td><code>Professional</code></td><td>Uses a formal and polished tone suitable for business or official communications.</td></tr><tr><td><code>Informal</code></td><td>A casual tone that feels relaxed and conversational.</td></tr><tr><td><code>Friendly</code></td><td>A warm and welcoming tone that makes the reader feel comfortable and appreciated.</td></tr><tr><td><code>Enthusiastic</code></td><td>A highly energetic tone that conveys excitement and eagerness.</td></tr><tr><td><code>Humorous</code></td><td>A light-hearted tone that incorporates humor to engage the audience.</td></tr><tr><td><code>Inspirational</code></td><td>A motivating tone that encourages and uplifts the audience.</td></tr><tr><td><code>Persuasive</code></td><td>A compelling tone designed to influence and convince the audience.</td></tr><tr><td><code>Luxurious</code></td><td>A tone that conveys elegance, opulence, and high-quality experiences.</td></tr><tr><td><code>Conversational</code></td><td>A natural and interactive tone that mimics real-life conversations.</td></tr><tr><td><code>Educational</code></td><td>An informative tone that simplifies concepts for learning and understanding.</td></tr><tr><td><code>Emotional</code></td><td>A tone that evokes strong feelings and connects with the reader on a deeper level.</td></tr><tr><td><code>Authoritative</code></td><td>A confident and assertive tone that establishes trust and credibility.</td></tr><tr><td><code>Nostalgic</code></td><td>A tone that evokes memories of the past and creates a sense of longing.</td></tr><tr><td><code>Romantic</code></td><td>A tone filled with affection, passion, and emotional connection.</td></tr><tr><td><code>Playful</code></td><td>A tone that is fun, light, and full of joy, often using creative language.</td></tr><tr><td><code>Sarcastic</code></td><td>A witty and ironic tone used to make a point in a humorous or cutting way.</td></tr><tr><td><code>Urgent</code></td><td>A tone that creates a sense of immediacy and importance, prompting quick action.</td></tr><tr><td><code>Empathetic</code></td><td>A tone that shows understanding and care, connecting with the reader’s emotions.</td></tr><tr><td><code>Uplifting</code></td><td>A positive and encouraging tone designed to boost morale and inspire hope.</td></tr><tr><td><code>Minimalist</code></td><td>A tone that is simple, clear, and concise, focusing only on essential details.</td></tr></tbody></table>

***

### 7. `AdTextEmojiSelection`

## AdTextEmojiSelection Enum Documentation

### Overview

The `AdTextEmojiSelection` enum is used to define the emoji preference for AI-generated ad texts. This enum is represented by integers when sent as parameters in API requests.

### Enum Definition

```csharp
namespace AdCreative.AdGenius.API.Enums.AdTextGeneration;

/// <summary>
/// The ad text emoji selection for AI.
/// </summary>
public enum AdTextEmojiSelection
{
    /// <summary>
    /// Text with emojis.
    /// </summary>
    WithEmojis,

    /// <summary>
    /// Text without emojis.
    /// </summary>
    WithoutEmojis,

    /// <summary>
    /// Text chosen by AI.
    /// </summary>
    ChosenByAi,
}
```

### JSON Representation

### Definition

```json
{
  "AdTextEmojiSelection": [
    "WithEmojis": 0,
    "WithoutEmojis": 1,
    "ChosenByAi": 2,
  ]
}
```

When using this enum in an API request, it is represented as integers:

```json
{
  "emojiPreference": 0 // Example: With Emojis
}
```

### Enum Values and Descriptions

<table><thead><tr><th width="129">Value</th><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><code>0</code></td><td>WithEmojis</td><td>Text with emojis.</td></tr><tr><td><code>1</code></td><td>WithoutEmojis</td><td>Text without emojis.</td></tr><tr><td><code>2</code></td><td>ChosenByAi</td><td>Text preference chosen by the AI.</td></tr></tbody></table>

***

### Example Usage

#### C# Example

```csharp
var selection = AdTextEmojiSelection.ChosenByAi;
Console.WriteLine((int)selection); // Outputs: 2
```

#### API Request Example

Using Postman or any HTTP client:

**Request Body**

```json
{
  "emojiSelection": 1
}
```

**Explanation**

* `emojiPreference`: Specifies whether the generated text should include emojis (`0`), exclude emojis (`1`), or let the AI decide (`2`).

***

### Notes

* Ensure the value sent matches the defined range (`0`, `1`, or `2`).
* The default behavior should be explicitly defined in your application logic if no value is provided.

This document serves as a reference for all enum definitions, ensuring consistent and correct usage in JSON requests and responses.

***


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-docs.adcreative.ai/docs/getting-started/enums-and-descriptions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.