Partner Ads
🚀 AI Wallpaper API Documentation 🌐
🔓 Free & Unlimited API Access - Just register, generate an API key, and start using our AI-powered endpoints!
🛠 Getting Started
To access our API, follow these simple steps:
1️⃣ Register/Login - Create an account to generate your free API
key.
2️⃣ Get Your API Key - Once logged in, generate your API
key
from the dashboard.
3️⃣ Use API Key in Headers - All requests
require the API key in the headers.
4️⃣ Send POST Requests - Our
API
supports only POST requests.
Base URL (POST Method):
🔑 Authentication & API Key Usage
Every API request must include your API key in the headers:
📂 Available API Endpoints
📚 Categories
📌 POST /categories
🔍 Retrieve a list of AI wallpaper categories.
📥 Request Parameters: None
📤 Response Example:
Success Result:
{
"success": true,
"code": 200,
"message": "Categories retrieved successfully",
"categories": [
{
"title": "Nature",
"identifier": "nature",
"image_url": "https://aivana.in/images/aicategory/nature-icon.png"
},
{
"title": "Abstract",
"identifier": "abstract",
"image_url": "https://aivana.in/images/aicategory/abstract-icon.png"
}
]
}🖼AI Wallpapers
📌 POST /wallpapers
🔍 Fetch all AI wallpapers.
📥 Request Parameters: None
📤 Response Example:
Success Result:
{
"success": true,
"code": 200,
"message": "Wallpapers retrieved successfully",
"next_page_url": null,
"prev_page_url": null,
"wallpapers": [
{
"title": "Galaxy Vibes",
"thumbnail_portrait": "https://aivana.in/images/aiwallpaper/portrait/galaxy.jpg",
"thumbnail_landscape": "https://aivana.in/images/aiwallpaper/thumbs/galaxy.jpg",
"category": "Space",
"total_images": 10,
"views": 1250,
"access_key": "xyz123"
}
]
}📌 POST /wallpapers/search?tags=nature
🔍 Search for wallpapers using a single word.
📥 Request Parameters: tags
Success Result:
{
"success": true,
"code": 200,
"message": "Wallpapers retrieved successfully",
"next_page_url": null,
"prev_page_url": null,
"wallpapers": [
{
"title": "Galaxy Vibes",
"thumbnail_portrait": "https://aivana.in/images/aiwallpaper/portrait/galaxy.jpg",
"thumbnail_landscape": "https://aivana.in/images/aiwallpaper/thumbs/galaxy.jpg",
"category": "Space",
"total_images": 10,
"views": 1250,
"access_key": "xyz123"
}
]
}🔥 Popular Wallpapers
📌 POST /wallpapers/popular
📥 Request Parameters: None
📤 Response: Returns
the most viewed AI wallpapers.
Success Result:
{
"success": true,
"code": 200,
"message": "Wallpapers retrieved successfully",
"next_page_url": null,
"prev_page_url": null,
"wallpapers": [
{
"title": "Galaxy Vibes",
"thumbnail_portrait": "https://aivana.in/images/aiwallpaper/portrait/galaxy.jpg",
"thumbnail_landscape": "https://aivana.in/images/aiwallpaper/thumbs/galaxy.jpg",
"category": "Space",
"total_images": 10,
"views": 1250,
"access_key": "xyz123"
}
]
}🎭 Wallpapers by Category
📌 POST /wallpapers/category/{category}
📥 Request Parameters: category
📥 Response Example:
Success Result:
{
"success": true,
"code": 200,
"message": "Wallpapers retrieved successfully",
"next_page_url": null,
"prev_page_url": null,
"wallpapers": [
{
"title": "Mystic Forest",
"thumbnail_portrait": "https://aivana.in/images/aiwallpaper/portrait/forest.jpg",
"thumbnail_landscape": "https://aivana.in/images/aiwallpaper/thumbs/forest.jpg",
"category": "Nature",
"views": 740
}
]
}📂 Wallpaper Albums
📌 POST /wallpapers/album
📥 Request Parameters: access_key (Header Request)
Success Result:
{
"success": true,
"code": 200,
"message": "Album images retrieved successfully",
"next_page_url": "https://aivana.in/api/wallpapers/album?page=3",
"prev_page_url": "https://aivana.in/api/wallpapers/album?page=1",
"wallpapers": [
{
"dimensions": "1248x2208",
"size": "141.48 KB",
"url": "https://cdn.aivana.in/storage/aialbum/1dfd4f5df/super-car-67b31f3492db4.jpg"
},
{
"dimensions": "1248x2208",
"size": "144.82 KB",
"url": "https://cdn.aivana.in/storage/aialbum/1dfd4f5df/super-car-67b31f34930e2.jpg"
}
]
}🎥 Generate AI Wallpaper Video
📌 POST /wallpapers/generate-video
📥 Request Parameters: access_key
📤 Response:
Returns
the generated mp4 video url using AI wallpapers.
Success Result:
{
"success": true,
"message": "Video generated successfully.",
"code": 200,
"video_url": "https://cdn.aivana.in/reels/6f3e811f/video1.mp4"
}📂 Get Generated Videos by Access Key
📌 POST /wallpapers/videos
📥 Request Parameters: access_key using header
📤
Response: Returns
the generated mp4 video url using AI wallpapers.
Success Result:
{
"success": true,
"message": "Videos retrieved successfully.",
"code": 200,
"videos": [
"https://cdn.aivana.in/reels/6f3e811f/video1.mp4",
"https://cdn.aivana.in/reels/6f3e811f/video2.mp4",
"https://cdn.aivana.in/reels/6f3e811f/video3.mp4"
]
}⚙️ Custom API Settings
📌 POST /my-settings
📥 Request Parameters: None
📤 Response: Returns
user-specific API settings.
🎰 Lucky Spin (Bonus Feature)
📌 POST /lucky-spin
📥 Request Parameters: user_id
📤
Response: Returns an array of spin color and number.
📈 Update User Points
📌 POST /update-user-points
📥 Request Parameters: points, user_id
Success Result:
{
"success": true,
"code": 200,
"message": "Points updated successfully"
}🔐 Authentication
📌 POST /register
📥 Request Parameters: name, email, password
Success Result:
{
"success": true,
"code": 200,
"message": "OTP sent to your email, also check spam folder."
}🔐 Email OTP Verification
📌 📌 POST /register/verify-otp
📥 Request Parameters: otp, email
Success Result:
{
"success": true,
"code": 200,
"message": "Registration successful.",
"user_id": 123,
"name": User,
}🔐 User Login
(Required to save users points only for lucky spin, or any other)
📌 📌 POST /login
📥 Request Parameters: email, password
Success Result:
{
"success": true,
"code": 200,
"message": "Login successful.",
"user_id": 123,
"name": User,
}Failed Result:
{
"success": false,
"code": 400,
"message": "About the error."
}⚠ API Fair Use Policy 🚨
Dear Users,
To ensure a smooth experience for everyone, please follow our API Fair Use Policy:
✅ Use Responsibly - Generate videos in a reasonable and
non-abusive manner.
❌ No Spamming - Excessive or
automated requests may result in a temporary or permanent ban.
🚀
Respect Server Limits - Avoid overloading our system to maintain
high-speed performance for all users.
🔒 API Monitoring - We
actively monitor requests. Abuse will not be tolerated.
🔴 Violating these rules may result in API access being revoked!
