Prefer chatting over curling?

Try Memelord's official Grok Bot — prompt it for image and video memes powered by this API.

Open Grok Bot

Does your agent speak MCP?

Connect the hosted Memelord MCP server to Claude, ChatGPT, Cursor, and friends — same tools as this API, OAuth sign-in, no key to paste.

MCP & Skills

Authentication

All API requests require an API key in the Authorization header.

Get your API Key

Visit Developer Settings to create and manage your API keys.

Get Key

Looking for the easiest way to get started?

Once you have an API Key, simply copy & paste our LLM instructions to your favorite coding agent.

Copy to LLM

Tools API

Every tool in the Memelord MCP server that API keys can use is also a REST endpoint under /api/v1, with the same bearer key. Read-only endpoints are GET with query parameters (arrays accept repeated keys or comma-separated values; ids go in the path); everything that generates or edits is POST with a JSON body whose fields are the tool's inputs. Every parameter is described in the OpenAPI 3.1 document at https://www.memelord.com/api/v1/openapi.json (operationId is the tool name).

Tools marked Billable draw from your usage balance based on the underlying generation cost; discovery, status, and account endpoints are free.

Search the template library:

curl "https://www.memelord.com/api/v1/templates/search?query=when%20the%20deploy%20works&type=meme&limit=5" \
  -H "Authorization: Bearer mlord_live_YOUR_API_KEY"

Caption a classic template:

curl -X POST https://www.memelord.com/api/v1/memes/caption \
  -H "Authorization: Bearer mlord_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "developers fixing bugs at 3am", "count": 2}'

{
  "success": true,
  "prompt": "developers fixing bugs at 3am",
  "total_generated": 2,
  "results": [
    {
      "success": true,
      "url": "https://…/meme.png",
      "expires_in": "7 days",
      "template_name": "This Is Fine",
      "template_id": "…",
      "caption_slots": [{ "slot": 1, "text": "it's 3am and the build is green" }],
      "edit_handle": "0f1c…"
    }
  ]
}

Video endpoints answer right away with a job_id; poll GET /api/v1/video-jobs/{job_id} every few seconds until status is completed and read mp4_url:

curl -X POST https://www.memelord.com/api/v1/video-memes \
  -H "Authorization: Bearer mlord_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "shipping on Friday"}'

# → { "success": true, "jobs": [{ "job_id": "render-…", … }], … }

curl https://www.memelord.com/api/v1/video-jobs/render-… \
  -H "Authorization: Bearer mlord_live_YOUR_API_KEY"

# → { "job_id": "render-…", "status": "completed", "mp4_url": "https://…" }

Success is 200 with the tool's JSON result. Errors are { "success": false, "code": "…", "error": "…" }:

{
  "success": false,
  "code": "INVALID_PARAMETER",
  "error": "Invalid arguments for tool search_memes",
  "issues": [{ "code": "too_big", "path": ["limit"], "message": "…" }]
}

Quick Start: Image Meme API

Generate a rendered meme and get back a download URL:

curl -X POST https://www.memelord.com/api/v1/ai-meme \
  -H "Authorization: Bearer mlord_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "developer fixing bugs at 3am"}'

Endpoints

• POST /api/v1/ai-meme — Generates and renders memes, returns hosted download URLs
• POST /api/v1/ai-meme/edit — Edit the text of an existing meme using AI

Request Body

caption_style does not choose between caption and remix output — set mode for that.

Response (200)

{
  "success": true,
  "prompt": "when the code works on the first try",
  "total_generated": 2,
  "results": [
    {
      "success": true,
      "url": "https://...signed-download-url...",
      "expires_in": 86400,
      "template_name": "Drake Hotline Bling",
      "template_id": "abc-123",
      "template_url": "https://...template-source-url...",
      "template_data": {
        "render_mode": "template",
        "width": 1200,
        "height": 1200,
        "template": { ... },
        "caption": null,
        "expanded_height": null
      }
    }
  ]
}

Edit Endpoint

Edit the text of an existing meme. Provide the original template data and an instruction describing what to change.

For caption memes, caption_style can switch the rendered output between top, TikTok, and Snapchat styles. For template-mode memes, this parameter should not be sent.

Edit Response (200)

{
  "success": true,
  "url": "https://...signed-download-url...",
  "expires_in": 86400,
  "template_id": "abc-123",
  "template_data": { ... },
  "edit_summary": "Changed the top text to reference JavaScript"
}

Example Outputs

Quick Start: Video Meme API

Generate captioned video memes from your prompt. Videos are selected from the template library, captioned automatically, and rendered. Results are delivered via webhook.

• POST /api/v1/ai-video-meme — Generate video memes with AI captions
• POST /api/v1/ai-video-meme/edit — Edit the caption of an existing video meme
• GET /api/video/render/remote?jobId=... — Poll render job status

Request Body

Immediate Response (200)

{
  "success": true,
  "prompt": "when the code works on the first try",
  "total_requested": 1,
  "jobs": [
    {
      "job_id": "render-1740524400000-abc12",
      "template_name": "Surprised Pikachu Video",
      "template_id": "abc-123",
      "caption": "When the code works on the first try"
    }
  ],
  "message": "Render jobs started. Results will be POSTed to webhookUrl."
}

Webhook Payload

Each render job POSTs its result to your webhookUrl when complete.

{
  "jobId": "render-1740524400000-abc12",
  "success": true,
  "mp4Url": "https://...signed-url...",
  "templateName": "Surprised Pikachu Video",
  "templateId": "abc-123",
  "caption": "When the code works on the first try",
  "stats": { "renderTimeMs": 12340, "outputSizeMB": "2.34" }
}

Edit Endpoint

Edit the caption of an existing video meme. Provide the original caption and an instruction describing what to change.

Polling Job Status

Poll for render job status when not using webhooks:

// Pending
{ "status": "pending", "jobId": "render-..." }

// Completed
{
  "status": "completed",
  "jobId": "render-...",
  "mp4Url": "https://...signed-url...",
  "storagePath": "user-id/exports/ai-video-meme-....mp4"
}

// Failed
{ "status": "failed", "jobId": "render-...", "error": "Render timed out" }

Example Outputs

Generated with prompt: "something funny about startups"

Usage & Pricing

The API is usage-based. Each call draws from your account's usage balance in dollars, based on the cost of the underlying generation. Check spend anytime on Settings → Usage, and top up from billing settings.

View UsageAdd Usage

Model Pricing

These are the prices you pay per generation — what you see is what you are charged, drawn from your usage balance.

Video Edits

Image Edits

Text & Token Models

Token models power meme text generation and editing. Most API calls combine a small amount of token usage with the image or video generation shown above.

Apply For Free Usage

We are generous lovers & generous in our support of developers. Apply today.

Why are you still here...

Create your key and get started now. Do it.

Get KeyAdd Usage

Need help? Contact support or visit Developer Settings to manage your API keys.