Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

abir-photo360-apis

MR-IMRAN-60964ISC1.0.2

Unofficial API wrapper for generating ephoto360.com image effects

ephoto, ephotoapi, textmaker, imran-photo360-apis, ephoto360

readme

🌟 Photo360 Text Effect Generator 📸

IMRAN PHOTO API

A dynamic Node.js module for generating custom text effects using ePhoto360.com. Crafted with reliability and extensibility in mind.

License Version

✨ Features

  • 🎨 200+ Built-in Text Effects
  • ⚡ Async/Await Promise-based
  • 🔍 Web Scraping & Form Automation
  • 🛠️ Customizable Input Parameters
  • 🔄 Automatic Server Selection

📦 Installation

npm install abir-photo360-apis

🚀 Quick Start

const Photo360 = require('abir-photo360-apis');

async function createEffect() {
  const generator = new Photo360();
  generator.setName("Imran");

  try {
    const result = await generator.execute();
    console.log("Generated Image:", result.imageUrl);
  } catch (error) {
    console.error("Generation Error:", error.message);
  }
}

createEffect();

📚 API Documentation

📋 Constructor

new Photo360(url?: string)
  • url: ePhoto360 effect page URL (default: Foggy Glass effect)

🔧 Methods

setName(name: string | string[])

Set text input(s) for the effect

execute(): Promise<ResultObject>

Processes the effect generation

📌 Result Object

{
  status: boolean,
  imageUrl: string,
  sessionId: string,
  author: string,
  contact: string
}

🖼️ Example Output

{
  "status": true,
  "imageUrl": "https://server12.ephoto360.com/output/123456.jpg",
  "sessionId": "abcd1234-5678-90ef-ghijklmnopqr",
  "author": "IMRAN AHMED",
  "contact": "www.facebook.com/Imran.Ahmed099"
}

🚨 Error Handling

Common Error Types:

  1. Invalid URL Error - Non-ePhoto360 URLs
  2. Form Parsing Error - Unexpected page structure
  3. Server Connection Error - Failed API calls
try {
  // Generation code
} catch (error) {
  if (error.message.includes('Unexpected token')) {
    console.error('⚠️ Invalid effect page structure');
  }
  // Add custom error handling
}

🌐 Supported Effects

Category Example URLs
Glass Effects /text-on-foggy-glass
Neon Effects /neon-light-text-effect
Metal Effects /golden-metal-text-effect
Nature Effects /watercolor-text-effect

📝 Notes

  1. Requires Node.js 16+
  2. Uses Cheerio for DOM manipulation
  3. Auto-handles cookies and sessions
  4. Randomizes server selection for reliability

Maintainer: Mohammad Imran
Original Author: Faris Ali
Contribution: PRs welcome!
License: MIT © 2024-2025 `

This design features:

  1. Clear visual hierarchy with emoji markers
  2. Interactive code samples
  3. Responsive badges
  4. Error handling guide
  5. API documentation table
  6. Mobile-friendly layout
  7. Quick reference tables
  8. Social media integration
  9. Version compatibility info
  10. Maintainer/contributor section

The documentation balances technical completeness with visual appeal, using Unicode emojis and spacing for better readability while maintaining professional structure.