Metadata-Version: 2.4
Name: memeclip
Version: 0.1.0
Summary: Official Python SDK for MemeClip's AI Meme Generator API
Home-page: https://github.com/memeclip/memeclip-ai-api
Author: MemeClip
Author-email: service.memeclip@gmail.com
Project-URL: Bug Tracker, https://github.com/memeclip/memeclip-ai-api/issues
Project-URL: Documentation, https://memeclip.ai
Project-URL: Homepage, https://memeclip.ai
Keywords: meme,ai meme generator,video meme generator,video meme,meme image
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Requires-Dist: pillow>=8.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# MemeClip AI API

<p align="center">
<img src="https://raw.githubusercontent.com/memeclip/memeclip-ai-api/refs/heads/main/assets/logo.png" alt="MemeClip AI API Logo" width="250"/>
</p>

<p align="center">
<a href="https://pypi.org/project/memeclip/"><img src="https://img.shields.io/pypi/v/memeclip.svg" alt="PyPI Version"></a>
<a href="https://github.com/memeclip/memeclip-ai-api/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a>
<a href="https://twitter.com/MemeClip_AI"><img src="https://img.shields.io/twitter/follow/MemeClip_AI?style=social" alt="Twitter Follow"></a>
</p>

## 🔥 Integrate AI-generated memes into your product at scale

MemeClip's official Python SDK and API lets you harness the power of our AI meme generator directly in your applications, websites, and workflows.

[MemeClip](https://memeclip.ai) is the leading AI meme maker that turns text into trending memes and videos - now available via API for developers!

## ✨ Features

- **1-Tap MagicMake** - Generate viral-worthy memes with a single API call
- **1,000+ Meme Styles** - Access our vast library of templates optimized for all social platforms
- **Always Trending** - Our API constantly updates with the latest meme formats and trends
- **Multilingual Support** - Create memes in multiple languages to reach global audiences
- **High Performance** - Fast response times with our optimized cloud infrastructure
- **Simple Integration** - Easy-to-use SDK with comprehensive documentation

## 📦 Installation

```bash
pip install memeclip
```

## 🚀 Quick Start

```python
from memeclip import MemeClip

# Initialize with your API key
api = MemeClip(api_key="your_api_key")

# Generate a meme from text
meme = api.create_meme(
    text="When you finally fix that bug after 5 hours",
    style="tech",  # Optional: specify meme style category
    format="image"  # Options: "image" or "video"
)

# Save the meme locally
meme.save("awesome_meme.jpg")

# Or get the URL to share
meme_url = meme.url
print(f"Share your meme: {meme_url}")
```

## 📚 Documentation (ToBeDone)

For detailed documentation, visit [docs.memeclip.ai](https://memeclip.ai) or check out these guides:

- [Authentication](https://memeclip.ai/)
- [Creating Memes](https://memeclip.ai/)
- [Meme Styles](https://memeclip.ai/)
- [Video Memes](https://memeclip.ai/)
- [Rate Limits](https://memeclip.ai/)

## 🔑 Authentication (ToBeDone)

Sign up for an API key at [memeclip.ai](https://memeclip.ai).

Set your API key as an environment variable (recommended):

```bash
export MEMECLIP_API_KEY="your_api_key"
```

Or pass it directly when initializing the client:

```python
from memeclip import MemeClip
api = MemeClip(api_key="your_api_key")
```

## 💻 API Reference

### Creating Memes

```python
# Create a basic meme
meme = api.create_meme(text="Your funny text here")

# Create a meme with specific style
meme = api.create_meme(
    text="Your funny text here",
    style="gaming"
)

# Create a video meme
video_meme = api.create_meme(
    text="When the code works on the first try",
    format="video",
    duration=10  # in seconds
)

# Add custom tags for better meme matching
meme = api.create_meme(
    text="Your funny text here",
    tags=["coding", "python", "bugs"]
)
```

### Managing Memes

```python
# List your created memes
memes = api.list_memes(limit=10)

# Get details of a specific meme
meme = api.get_meme(meme_id="meme_123456")

# Delete a meme
api.delete_meme(meme_id="meme_123456")
```

## 📱 Use Cases

- **Social Media Management** - Automate meme creation for your social media calendar
- **Content Marketing** - Generate engaging visual content for marketing campaigns
- **Community Platforms** - Allow users to create memes directly within your platform
- **Customer Support** - Add humor to your customer interactions with contextual memes
- **Educational Tools** - Make learning more engaging with relevant, funny memes
- **Chat Applications** - Enhance messaging with inline meme generation

## 🔐 Security

We take security seriously. All API requests are made over HTTPS and your API keys should be kept secure. Never expose your API key in client-side code.

## 💰 Pricing

**Current Free**

## 🤝 Support

- **Email**: service.memeclip@gmail.com
- **Twitter**: [@MemeClip_AI](https://twitter.com/MemeClip_AI)
- **Issues**: [GitHub Issues](https://github.com/memeclip/memeclip-ai-api/issues)

## 📄 License

[MIT License](LICENSE) 
