M
MemeGen AI
Overview

API Reference

v1

Complete reference for the MemeGen AI REST API v1. All endpoints return JSON unless specified otherwise.

Base URL: http://localhost:3000
Auth: API Key
Format: JSON

Authentication

All authenticated requests require an API key.

1

Create account & get your API key

Register via the API to get your API key instantly. You can also sign up on the website and create keys from Account Settings.

POSThttp://localhost:3000/api/auth/register

Request body

{
  "name": "John Doe",
  "email": "john@example.com",
  "password": "yourpassword",
  "confirmPassword": "yourpassword"
}
curl -X POST http://localhost:3000/api/auth/register \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "name": "John Doe", "email": "john@example.com", "password": "yourpassword", "confirmPassword": "yourpassword" }'
201 Created
{
  "id": "usr_abc123",
  "name": "John Doe",
  "email": "john@example.com",
  "emailVerified": false,
  "avatarUrl": null,
  "createdAt": 1710000000,
  "apiKey": "meme_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}

Store your apiKey securely. It is only returned once.

or

Already have an account? Get a new API key

Exchange your email and password for a new API key. You can also create keys from Account Settings.

POSThttp://localhost:3000/api/auth/token

Request body

{
  "email": "john@example.com",
  "password": "yourpassword"
}
curl -X POST http://localhost:3000/api/auth/token \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "email": "john@example.com", "password": "yourpassword" }'
200 OK
{
  "id": "usr_abc123",
  "name": "John Doe",
  "email": "john@example.com",
  "emailVerified": true,
  "avatarUrl": null,
  "apiKey": "meme_x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5k4"
}
2

Add it to your requests

Include your API key in the Authorization header of every request:

Example request
curl -X POST http://localhost:3000/api/meme/generate \
  -H "Authorization: Bearer meme_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "idea": "When the code works on first try" }'

Endpoints marked with Auth require an API key. Public endpoints (like browsing templates) can be called without authentication. API usage counts against your plan's monthly request limit.

Meme Templates

Browse and search meme & GIF templates from our database.

Meme Generation

Generate memes with AI, save them, and manage your generation history.

Auth
Auth
Auth
Auth

User Profile

Manage your profile and view credits.

Auth
Auth

User Templates

Create and list your custom meme templates.

Auth
Auth

Posts

Create and list content posts.

Auth
Auth

Website Analysis

Analyze websites with AI to generate tailored meme marketing ideas.

Auth
Auth

Image Upload

Upload images for use in memes and templates.

Auth

MemeGen AI API v1 Documentation ยท Back to Overview