Beauty Generation API - Integration Guide

🖼️ Example Generated Images

Here are some examples of images generated by our Beauty Generation API:

Professional Portrait

High-quality beauty portrait with professional lighting

Elegant Style

Sophisticated portrait with elegant styling and composition

Natural Beauty

Stunning portrait with natural lighting and effortless elegance

Radiant Charm

Captivating portrait with radiant expression and refined beauty

✨ These are just examples! With our API, you can generate unlimited variations by adjusting parameters like style, nationality, age, clothing, and scene. Visit diversityfaces.org to explore a vast collection of images generated using this API.

🔑 API Authentication

All API calls require a valid API Key for authentication. Get your API key by visiting API Key Request. A donation of $5 entitles you to an API key with a credit of 1,000 images. Please include your Request ID in the donation message. Your API key will be activated within 24 hours of receiving your donation.

                    # Method 1: Using X-API-Key header
                    X-API-Key: YOUR_API_KEY

                    # Method 2: Using Authorization header
                    Authorization: Bearer YOUR_API_KEY
                

API Service Endpoint

Production: https://gen1.diversityfaces.org

How to Get Your API Key

Visit https://gen1.diversityfaces.org/api-key-request to submit your API key request. A $5 donation entitles you to an API key with a credit of 1,000 images. Please include your Request ID in the donation message. Your API key will be activated within 24 hours of receiving your donation.

Authentication Error Handling

Error Type	HTTP Status	Error Code	Description
Missing API Key	401	MISSING_API_KEY	API key not included in request headers
Invalid API Key	401	INVALID_API_KEY	Provided API key is invalid or expired
API Key Expired	401	EXPIRED_API_KEY	API key has expired, needs to be updated
Rate Limit Exceeded	429	RATE_LIMIT_EXCEEDED	API key call limit has been reached

📋 API Key Request System

We provide an API Key management system with donation-based approval. Support the service and get access:

Current Configuration

💛 Approval Mode: Donation-Based

A $5 donation is required. Include your Request ID in the donation message. API key activated within 24 hours of receiving your donation.

📊 Image Credit: 1,000 images per key

Each $5 donation entitles you to 1,000 image generations

⏰ Validity Period: 1 Year

API keys are valid for 365 days from creation date

How to Request Your API Key

Follow these steps to get your API key:

Step 1: Visit the Request Form

Go to API Key Request Form

Step 2: Fill in Your Information

Provide the following details:

Username: Your desired username (3-50 characters)
Email: Your email address for notifications
Country: Your country of residence

Step 3: Submit Your Request & Note Your Request ID

Click the submit button. Copy your Request ID — you will need it in the next step.

Step 4: Make a $5 Donation 💛

Donate $5 and include your Request ID in the donation message. A donation of $5 entitles you to an API key with a credit of 1,000 images.

Step 5: Wait for Activation ⏳

I will activate your API key within 24 hours of receiving your donation. You will be notified via email once your key is ready.

Using Your API Key

Include your API key in every API request using one of these methods:

                    # Method 1: Using X-API-Key header (Recommended)
                    curl -H "X-API-Key: YOUR_API_KEY" https://gen1.diversityfaces.org/api/generate

                    # Method 2: Using Authorization header
                    curl -H "Authorization: Bearer YOUR_API_KEY" https://gen1.diversityfaces.org/api/generate
                

API Key Features

1,000 Image Credits: Each $5 donation entitles you to 1,000 image generations
1 Year Validity: Valid for 365 days from creation
Secure Authentication: Secure API access control
Usage Tracking: Monitor your API call usage
Rate Limiting: Fair usage enforcement
Geolocation Tracking: Security and analytics

Check Your Request Status

If you need to check the status of your API key request, visit the API Key Status Page and enter your Request ID.

✨ Features

🔐 API Key Authentication

Secure API access control with valid API key requirement

🎯 Multiple Generation Modes

Support for standard, random, and custom prompt generation

🎨 Rich Parameter Options

100+ parameter combinations including style, age, nationality, scene, clothing

🛡️ Content Safety Filtering

Built-in intelligent safety checks ensuring healthy and compliant content

🖼️ Multiple Output Formats

Support for WebP, PNG, JPEG formats with configurable compression quality

⚡ Asynchronous Processing

Task queue management supporting concurrent generation and status queries

📖 API Endpoints

POST

Standard Generation

POST /api/generate

Generate beauty portraits with specified parameters including style, age, nationality, scene, clothing, etc.

Authentication: X-API-Key header required

POST

Random Generation

POST /api/generate/random

Generate portraits with randomly selected parameters, with option to override specific parameters.

Authentication: X-API-Key header required

POST

Custom Generation

POST /api/generate/custom

Generate portraits using custom full prompts for advanced customization.

Authentication: X-API-Key header required

GET

Status Query

GET /api/status/{prompt_id}

Query the current status of generation tasks including pending, processing, completed states.

Authentication: X-API-Key header required

GET

Image Retrieval

GET /api/image/{filename}

Retrieve generated image files with format conversion and quality adjustment support.

Authentication: X-API-Key header required

GET

Check Quota

GET /api/quota

Check your API key quota information including daily limits and remaining calls. Does NOT consume quota.

Authentication: X-API-Key header required
Returns: remaining_calls, daily_limit, daily_calls_today

GET

Presets Configuration

GET /api/presets

Get all available parameter preset options including styles, nationalities, clothing, etc.

Authentication: X-API-Key header required

⚙️ Parameters

Standard Generation Parameters

Parameter	Type	Required	Description	Example
style	string	No	Style type	pure, sexy, classical, modern
age	string	No	Age range	18-28
nationality	string	No	Nationality	Chinese, Japanese, Korean
scene	string	No	Scene/Background	indoor, outdoor, cafe
clothing	string	No	Clothing type	dress, cheongsam, suit
width	integer	No	Image width (multiple of 8)	1024, 1920
height	integer	No	Image height (multiple of 8)	1024, 1072
steps	integer	No	Sampling steps	4-20

💡 Code Examples

Check Your API Quota (Does NOT consume quota)

⚠️ Replace YOUR_API_KEY with your personal API key from API Key Request

                    # Check your remaining quota and daily limits
                    curl -H "X-API-Key: YOUR_API_KEY" \
                    https://gen1.diversityfaces.org/api/quota

                    # Response example:
                    {
                     "success": true,
                     "quota": {
                     "key_name": "My API Key",
                     "total_calls": 45,
                     "remaining_calls": 955,
                     "daily_limit": 1000,
                     "daily_calls_today": 45
                     }
                    }

                    # Understanding the response:
                    # - remaining_calls: Total calls left on your key (-1 = unlimited)
                    # - daily_limit: Maximum calls per day (resets every 24 hours)
                    # - daily_calls_today: Calls made today (resets after 24 hours)
                    # - If daily_calls_today >= daily_limit, you cannot make more calls until
                        tomorrow
                

Using curl for Image Generation

⚠️ Replace YOUR_API_KEY with your personal API key from API Key Request

                    # Step 1: Submit generation request
                    curl -X POST https://gen1.diversityfaces.org/api/generate/custom \
                    -H "Content-Type: application/json" \
                    -H "X-API-Key: YOUR_API_KEY" \
                    -d '{
                        "full_prompt": "A beautiful 25-year-old woman with long hair, elegant dress, professional
                        lighting",
                        "width": 1024,
                        "height": 1024
                        }'

                    # Response: {"success": true, "prompt_id": "abc123-def456", ...}

                    # Step 2: Poll status every 0.5 seconds until completed
                    curl -H "X-API-Key: YOUR_API_KEY" \
                    https://gen1.diversityfaces.org/api/status/abc123-def456

                    # Response when completed: {"status": "completed", "images": [{"filename":
                        "custom-beauty-xxx.png"}]}

                    # Step 3: Download the image
                    curl -H "X-API-Key: YOUR_API_KEY" \
                    "https://gen1.diversityfaces.org/api/image/custom-beauty-xxx.png?format=webp"
                    \
                    -o beauty.webp
                

🔒 Privacy Policy

Data Collection and Use

Information We Collect:

Basic information during API key application (username, email, country)
Prompt content in image generation requests
API usage statistics and access logs
IP address and geolocation for security purposes

Purpose of Data Use:

Provide AI image generation services
Improve service quality and user experience
Prevent abuse and ensure content safety
Comply with legal and regulatory requirements

Data Protection Measures

Industry-standard encryption for data transmission
Strict access control and permission management
Regular security audits and vulnerability scanning
Data minimization principle - only collect necessary information

Data Sharing and Disclosure

We do not sell, rent, or otherwise disclose your personal information to third parties, except:

With your explicit consent
Required by law or regulation
To protect our legitimate interests
To prevent fraud or security threats

User Rights

You have the right to:

Access and view your personal data
Request correction of inaccurate information
Request deletion of your personal data
Withdraw consent and stop using the service

To exercise these rights, please contact us: Discord Support

📋 Terms of Service

Service Usage Rules

Permitted Use:

Legal creative and commercial purposes
Professional avatar and portrait generation
Character design and artistic creation
Fashion and style visualization

Prohibited Use:

Generate images of minors
Create pornographic or sexually suggestive content
Generate violent, hateful, or discriminatory content
Impersonate real people or create deepfakes
Use for fraud, scams, or other illegal activities

Intellectual Property

Generated images belong to users, subject to usage restrictions
Users may not claim rights to AI models or service technology
Respect third-party intellectual property rights
Commercial use must comply with applicable laws

Service Limitations and Liability

Service Limitations:

API call count and rate limits
Content safety filtering may affect generation results
Service availability not guaranteed 100%
We reserve the right to modify or terminate services

Liability Limitations:

Users bear full responsibility for use of generated content
Service provider not liable for users' illegal use
No guarantee of accuracy or suitability of generated content
Liability for losses limited to service fees

Dispute Resolution

Disputes preferably resolved through friendly negotiation
Governed by laws of service provider's jurisdiction
Legal proceedings in service provider's jurisdiction
Contact: Discord Support

📅 Last Updated: 20260401
📧 For questions, please contact: Discord Support

⚠️ Important Legal Notice & Privacy Protection

🔒 Data Privacy

🚫 Content Restrictions

⚖️ Legal Responsibility

🔐 API Key Security

1. Beauty Generation API , 2. Image Editing API

Soulist: AI Soul Exploration & Digital Immortality

🖼️ Example Generated Images

🔑 API Authentication

API Service Endpoint

How to Get Your API Key

Authentication Error Handling

📋 API Key Request System

Current Configuration

How to Request Your API Key

Using Your API Key

API Key Features

Check Your Request Status

✨ Features

🔐 API Key Authentication

🎯 Multiple Generation Modes

🎨 Rich Parameter Options

🛡️ Content Safety Filtering

🖼️ Multiple Output Formats

⚡ Asynchronous Processing

📖 API Endpoints

Standard Generation

Random Generation

Custom Generation

Status Query

Image Retrieval

Check Quota

Presets Configuration

⚙️ Parameters

Standard Generation Parameters

💡 Code Examples

Check Your API Quota (Does NOT consume quota)

Using curl for Image Generation

🔒 Privacy Policy

Data Collection and Use

Data Protection Measures

Data Sharing and Disclosure

User Rights

📋 Terms of Service

Service Usage Rules

Intellectual Property

Service Limitations and Liability

Dispute Resolution

1. Beauty Generation API ,
2. Image Editing API