Special Recommendation

Soulist: AI Soul Exploration & Digital Immortality

A unique soul is the most precious treasure of the AI era. Here, you can explore and experience a diverse array of captivating digital souls—and engage in deep, meaningful conversations with them. You can even extract your own beautiful soul and grant it digital immortality right here. Start exploring and sharing these soul-to-soul connections today.

VISIT SOULSTYLES.ORG

🖼️ Example Edited Images

Here are some examples of images that have been processed through our Image Editing API with various editing instructions:

Before: Original
Before
After: Smiling
After

😊 Make Person Smile

Intelligent facial expression editing to make the person smile naturally

Before: Original
Before
After: Smiling
After

😊 Make Person Smile

AI-powered facial expression modification to enhance attractiveness and warmth

✨ These are example results! With our API, you can edit any image using text instructions for enhancements, color grading, artistic effects, and more. Visit diversityfaces.org to explore more about our services.

🔑 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 image edits. 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://edit1.diversityfaces.org

How to Get Your API Key

Visit https://edit1.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 image edits. 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 image edits per key

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

⏰ 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 image edits.

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://edit1.diversityfaces.org/api/edit/custom # Method 2: Using Authorization header curl -H "Authorization: Bearer YOUR_API_KEY" https://edit1.diversityfaces.org/api/edit/custom

API Key Features

  • 1,000 Image Edits: Each $5 donation entitles you to 1,000 image edits
  • 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 API key requirement for protected endpoints

🎯 Multiple Operation Modes

Support for parameter-based generation, random generation, custom prompts, and image editing

🎨 Rich Parameter Options

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

🛡️ Content Safety Filtering

Built-in intelligent safety checks ensuring healthy and compliant content generation

🖼️ Multiple Output Formats

Support for WebP, PNG, JPEG formats with configurable compression quality on-the-fly

⚡ Asynchronous Processing

Task queue management supporting concurrent operations and real-time status queries

📖 API Endpoints

POST

Image Edit

POST /api/edit/custom

Edit an uploaded image with a text instruction. Submit image file and editing prompt for AI-powered image editing.

Authentication: X-API-Key header required
Content-Type: multipart/form-data

GET

Check Task Status

GET /api/status/{task_id}

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

Authentication: X-API-Key header required
Returns: status, images (filename)

GET

Retrieve Result Image

GET /api/image/{filename}

Retrieve edited image files with optional format conversion and quality adjustment.

Authentication: X-API-Key header required
Query Parameters: format (jpg, png, webp), quality (1-100)

GET

Check API 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

⚙️ Parameters

Image Edit Parameters (POST /api/edit/custom)

Parameter Type Required Description Example
image file Yes Image file to edit (multipart form) image.jpg
full_prompt string Yes Text instruction for editing the image enhance colors and increase brightness
width integer No Output width in pixels (default: 1024) 512, 1024, 1920
height integer No Output height in pixels (default: 1024) 512, 1024, 1072
steps integer No Number of processing steps 4-20
seed integer No Random seed for reproducibility (-1 for auto) 42, -1
guidance_scale float No Guidance scale for prompt adherence 1.0

💡 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://edit1.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

Edit an Image with Text Instruction

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

# Step 1: Submit image editing request # Example: Make the person smile curl -X POST https://edit1.diversityfaces.org/api/edit/custom \ -H "X-API-Key: YOUR_API_KEY" \ -F "image=@source_image.jpg" \ -F "full_prompt=Make Person Smile" \ -F "width=1024" \ -F "height=1024" # Response example: { "success": true, "task_id": "edit-abc123-def456", "prompt_id": "edit-abc123-def456", "message": "Image edit task submitted" } # Step 2: Poll status every 0.5 seconds until completed curl -H "X-API-Key: YOUR_API_KEY" \ https://edit1.diversityfaces.org/api/status/edit-abc123-def456 # Response when completed: { "status": "completed", "images": [{"filename": "edited-image-xyz.png"}], "message": "Image generation completed" } # Step 3: Download the edited image curl -H "X-API-Key: YOUR_API_KEY" \ https://edit1.diversityfaces.org/api/image/edited-image-xyz.png?format=webp&quality=85 \ -o result.webp

Python Example: Complete Image Editing Workflow

⚠️ Replace YOUR_API_KEY and image path with your actual values

import time import requests base = "https://edit1.diversityfaces.org" api_key = "YOUR_API_KEY" image_path = r"path/to/your/image.jpg" # Step 1: Submit editing request with open(image_path, "rb") as f: r = requests.post( base + "/api/edit/custom", headers={"X-API-Key": api_key}, files={"image": ("image.png", f, "image/png")}, data={ "full_prompt": "Make Person Smile", "width": "1024", "height": "1024", "steps": "4", "guidance_scale": "1.0", "seed": "-1", }, timeout=60, ) print("submit status:", r.status_code) r.raise_for_status() task_id = r.json()["prompt_id"] print("task_id:", task_id) # Step 2: Poll for completion (with timeout) for i in range(60): s = requests.get( base + f"/api/status/{task_id}", headers={"X-API-Key": api_key}, timeout=20, ) s.raise_for_status() data = s.json() status = data.get("status") if status == "completed": filename = data["images"][0]["filename"] print("filename:", filename) break elif status == "failed": raise RuntimeError(f"Task failed: {data}") time.sleep(5) else: raise TimeoutError("Task did not complete in time") # Step 3: Download the edited image img = requests.get( base + f"/api/image/{filename}", headers={"X-API-Key": api_key}, timeout=60, ) img.raise_for_status() with open("edit-output.webp", "wb") as out: out.write(img.content) print("Saved: edit-output.webp")

🔒 Privacy Policy

Data Collection and Use

Information We Collect:

  • Basic information during API key application (username, email, country)
  • Images submitted for editing
  • API usage statistics and access logs
  • IP address and geolocation for security purposes

Purpose of Data Use:

  • Provide AI image editing 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

© 2025 Image Editing API. All rights reserved.

Powered by diversityfaces.org | Visit Service

Privacy Policy | Terms of Service | Support