> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Memelord

> Memelord generates and edits image and video memes from prompts, with hosted results and asynchronous video rendering.

![Memelord logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/memelord.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=64970451188c9b9bce0e350e9d9f6a0e)

* **Category:** ai content generation
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 22
* **Triggers:** 0
* **Slug:** `MEMELORD`
* **Version:** 20261103\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Check Video Status
>
> **Slug:** `MEMELORD_CHECK_VIDEO_STATUS`
>
> Read one current Memelord Tools API video job. Poll every few seconds until its provider-defined status becomes completed or failed; completed jobs include the MP4 download URL.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Free
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> Job ID returned by a video-producing Memelord tool.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting in the query; never use an email or name.
>
> **end\_user\_id\_header** `string`
>
> Opaque end-user ID for usage reporting in the request header; never use an email or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit Image Meme
>
> **Slug:** `MEMELORD_EDIT_IMAGE_MEME`
>
> Create a paid edited image-meme render from a prior generation result. Pass its template ID and template data unchanged; the returned URL is temporary.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Depends on the provider
>
> **Discount:** 100
>
> #### Input Parameters
>
> **instruction** `string` *required*
>
> Natural-language instruction describing how to change the meme text.
>
> **template\_id** `string` *required*
>
> Template ID from the image-generation result being edited.
>
> **target\_index** `integer`
>
> One-based text-box index to edit; omit to let the provider choose the target.
>
> **caption\_style** `string ("tiktok" | "snapchat")`
>
> Caption style override for caption-mode memes only; omit it for template-mode memes to avoid a provider error.
>
> **template\_data** `object` *required*
>
> Complete template\_data object from the image-generation result; pass it unchanged because its nested layout schema is opaque and may contain provider-specific keys.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit Meme
>
> **Slug:** `MEMELORD_EDIT_MEME`
>
> Create a paid text edit of an image meme using its edit handle and return a fresh signed URL, updated caption slots, and a new edit handle.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \~\$0.01 per edit
>
> **Discount:** 100
>
> #### Input Parameters
>
> **edit\_handle** `string` *required*
>
> Edit handle returned by Generate Caption Meme, Generate AI Meme, or Edit Meme.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID sent in the JSON body for usage reporting.
>
> **instruction** `string` *required*
>
> Plain-language instruction describing what meme text to change.
>
> **target\_index** `integer`
>
> One-based caption slot number to change; omit to let the editor decide.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID sent in X-Memelord-End-User for usage reporting.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit Video Meme
>
> **Slug:** `MEMELORD_EDIT_VIDEO_MEME`
>
> Start a paid asynchronous render that edits a prior video meme's caption and can replace its audio with an overlay, which mutes the base audio. Poll the returned job with Get Video Render Status unless using a webhook.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Depends on the provider
>
> **Discount:** 100
>
> #### Input Parameters
>
> **caption** `string` *required*
>
> Current caption text from the video-generation result.
>
> **instruction** `string` *required*
>
> Natural-language instruction describing how to change the video caption.
>
> **template\_id** `string` *required*
>
> Video template ID from the generation result being edited.
>
> **webhook\_url** `string`
>
> URL to receive the completed edited render; omit it to poll job status instead.
>
> **audio\_overlay\_url** `string`
>
> Audio URL to overlay on the edited video; providing it mutes the base video's audio.
>
> **force\_caption\_style** `string ("top" | "tiktok")`
>
> Force top letterbox or centered-overlay TikTok captions instead of dimension-based styling.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fulfill Meme Request With Jester
>
> **Slug:** `MEMELORD_FULFILL_MEME_REQUEST_WITH_JESTER`
>
> Run Memelord's paid Jester agent for a natural-language meme request that does not map cleanly to a specific tool. It may return images immediately and video job IDs that require separate polling.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** From \~\$0.02 per request, plus what Jester generates
>
> **Discount:** 100
>
> #### Input Parameters
>
> **count** `integer`
>
> Number of results to request; Memelord defaults to one.
>
> **prompt** `string` *required*
>
> Natural-language request for the Jester meme agent.
>
> **thread\_id** `string`
>
> Thread ID from an earlier agent result when continuing a conversation.
>
> **image\_urls** `array`
>
> Up to five public image URIs for Jester to use.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting, sent in the JSON body; never send an email address or name.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID for usage reporting, sent in the X-Memelord-End-User header; never send an email address or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate AI Meme
>
> **Slug:** `MEMELORD_GENERATE_AI_MEME`
>
> Create paid AI-remixed image memes by editing a template picture to fit the joke, optionally using reference images. Returns signed image URLs, caption slots, and edit handles.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \~\$0.10 per meme
>
> **Discount:** 100
>
> #### Input Parameters
>
> **count** `integer`
>
> Number of memes to generate; the provider defaults to 1.
>
> **prompt** `string` *required*
>
> Topic, idea, or joke premise for the meme.
>
> **category** `string ("trending" | "classic")`
>
> Restrict template selection to trending or classic templates.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID sent in the JSON body for usage reporting.
>
> **template\_id** `string`
>
> Image template asset ID returned by meme search or trending memes.
>
> **include\_nsfw** `boolean`
>
> Whether NSFW-tagged templates may be selected; the provider defaults to true.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID sent in X-Memelord-End-User for usage reporting.
>
> **include\_political** `boolean`
>
> Whether political-tagged templates may be selected; the provider defaults to true.
>
> **reference\_image\_urls** `array`
>
> Up to 3 public image URIs for a person, product, logo, or style to paint into the meme.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate Caption Meme
>
> **Slug:** `MEMELORD_GENERATE_CAPTION_MEME`
>
> Create paid classic image memes by writing new captions on unchanged templates. Returns signed image URLs, caption slots, and edit handles.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \~\$0.02 per request
>
> **Discount:** 100
>
> #### Input Parameters
>
> **count** `integer`
>
> Number of memes to generate; the provider defaults to 1.
>
> **prompt** `string` *required*
>
> Topic, idea, or joke premise for the meme.
>
> **category** `string ("classic" | "trending")`
>
> Use classic caption-slot templates or current trending templates.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID sent in the JSON body for usage reporting.
>
> **template\_id** `string`
>
> Image template asset ID returned by meme search or trending memes.
>
> **include\_nsfw** `boolean`
>
> Whether NSFW-tagged templates may be selected; the provider defaults to true.
>
> **caption\_style** `string ("tiktok" | "snapchat")`
>
> Rendering style for single-caption memes; multi-slot templates ignore it.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID sent in X-Memelord-End-User for usage reporting.
>
> **include\_political** `boolean`
>
> Whether political-tagged templates may be selected; the provider defaults to true.
>
> **use\_search\_context** `boolean`
>
> Whether to ground the joke in live web search results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate or Edit Video With Gemini Omni
>
> **Slug:** `MEMELORD_GENERATE_EDIT_VIDEO_WITH_GEMINI_OMNI`
>
> Start a paid Gemini Omni video job to edit an existing clip, animate a still image, or generate a short clip from a prompt. Poll the returned job ID for completion.
>
> #### Input Parameters
>
> **title** `string`
>
> Short title for the saved video.
>
> **prompt** `string` *required*
>
> What to generate, or what to change about the source clip.
>
> **image\_url** `string`
>
> Public URL of a still image to animate.
>
> **video\_url** `string`
>
> Public URL of the clip to edit; use the URL returned by Memelord media upload for a local file.
>
> **end\_user\_id** `string`
>
> Opaque ID of the end user behind this call for usage reporting; never send an email address or name.
>
> **video\_job\_id** `string`
>
> Job ID of a finished video on this account to edit instead of video\_url.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID sent in X-Memelord-End-User for usage reporting.
>
> **reference\_image\_urls** `array`
>
> Up to 3 public reference image URLs for identity, product, or style.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate Image Memes
>
> **Slug:** `MEMELORD_GENERATE_IMAGE_MEMES`
>
> Generate 1-10 hosted image memes from a prompt. Each requested meme consumes paid usage, and returned URLs are temporary.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \~\$0.10 per meme
>
> **Discount:** 100
>
> #### Input Parameters
>
> **mode** `string ("remix" | "caption")`
>
> Use remix to AI-edit the image and caption, or caption to render text on an unchanged classic template.
>
> **count** `integer`
>
> Number of memes to generate (1-10); each meme is billed individually.
>
> **prompt** `string` *required*
>
> Topic or idea the generated memes should express.
>
> **category** `string ("trending" | "classic")`
>
> Template category to use when selecting a meme format.
>
> **include\_nsfw** `boolean`
>
> Whether NSFW templates may be selected; the provider defaults to true.
>
> **caption\_style** `string ("tiktok" | "snapchat")`
>
> Style for single-caption rendering; multi-slot templates ignore it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate Video Meme
>
> **Slug:** `MEMELORD_GENERATE_VIDEO_MEME`
>
> Start paid video-meme render jobs through the current Memelord Tools API. Returns provider-defined job objects immediately; poll each job ID with Check Video Status until it completes.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \~\$0.02 per video meme
>
> **Discount:** 100
>
> #### Input Parameters
>
> **count** `integer`
>
> Number of video memes to generate; the provider defaults to 1.
>
> **prompt** `string` *required*
>
> Topic or idea for the video meme.
>
> **category** `string ("trending" | "classic")`
>
> Restrict template selection to trending or classic templates.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting in the request body; never use an email or name.
>
> **template\_id** `string`
>
> Specific video template asset ID from Search Memes.
>
> **include\_nsfw** `boolean`
>
> Whether NSFW-tagged templates may be selected; the provider defaults to true.
>
> **include\_political** `boolean`
>
> Whether political-tagged templates may be selected; the provider defaults to true.
>
> **end\_user\_id\_header** `string`
>
> Opaque end-user ID for usage reporting in the request header; never use an email or name.
>
> **force\_caption\_style** `string ("top" | "tiktok")`
>
> Force top letterbox or centered-overlay TikTok captions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate Video Memes
>
> **Slug:** `MEMELORD_GENERATE_VIDEO_MEMES`
>
> Start 1-5 paid asynchronous video-meme renders from a prompt and return job IDs. Poll each job with Get Video Render Status unless using a webhook.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \~\$0.02 per video meme
>
> **Discount:** 100
>
> #### Input Parameters
>
> **count** `integer`
>
> Number of asynchronous video renders to start (1-5); each video is billed individually.
>
> **prompt** `string` *required*
>
> Topic or idea the generated video memes should express.
>
> **category** `string ("trending" | "classic")`
>
> Template category to use when selecting a video format.
>
> **template\_id** `string`
>
> Specific video template ID to use instead of automatic template selection.
>
> **webhook\_url** `string`
>
> HTTP(S) URL to receive completed render results; omit it to poll job status instead.
>
> **webhook\_secret** `string`
>
> Secret the provider uses for HMAC-SHA256 webhook signing; use only with webhook\_url.
>
> **force\_caption\_style** `string ("top" | "tiktok")`
>
> Force top letterbox or centered-overlay TikTok captions instead of dimension-based styling.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account
>
> **Slug:** `MEMELORD_GET_ACCOUNT`
>
> Get the authenticated Memelord account, usage balance, billable-tool availability, credit URL, authentication mode, and reported end-user ID.
>
> #### Input Parameters
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting, sent as a query parameter; never send an email address or name.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID for usage reporting, sent in the X-Memelord-End-User header; never send an email address or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Meme Template
>
> **Slug:** `MEMELORD_GET_MEME_TEMPLATE`
>
> Fetch one Memelord template asset by ID to inspect its media, metadata, dimensions, tags, and text-slot count before generation.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Free
>
> #### Input Parameters
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting; never send an email address or name.
>
> **template\_id** `string` *required*
>
> Template asset ID returned by meme search or trending memes.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID sent in X-Memelord-End-User instead of end\_user\_id; never send an email address or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Video Render Status
>
> **Slug:** `MEMELORD_GET_VIDEO_RENDER_STATUS`
>
> Get the current state of one asynchronous video render job and, when completed, its temporary MP4 URL. Performs one status read and does not poll.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Free
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> Render job ID returned by video generation or video editing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Image Tools
>
> **Slug:** `MEMELORD_LIST_IMAGE_TOOLS`
>
> List one-shot image tools available to the connected Memelord account, including each tool's ID, required inputs, and extra parameters.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Free
>
> #### Input Parameters
>
> **category** `string ("image-to-image" | "image-text-to-image" | "text-to-image")`
>
> Filter tools by their input contract.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting; never send an email address or name.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID sent in X-Memelord-End-User instead of end\_user\_id; never send an email address or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Trending Memes
>
> **Slug:** `MEMELORD_LIST_TRENDING_MEMES`
>
> List the newest curated trending meme templates with cultural context, optionally restricted to images or videos. NSFW drops are excluded.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Free
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of trending templates to return; the provider defaults to 3.
>
> **media\_type** `string ("image" | "video")`
>
> Return only still images or only video clips; omit for a mix.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting; never send an email address or name.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID sent in X-Memelord-End-User instead of end\_user\_id; never send an email address or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Video Models
>
> **Slug:** `MEMELORD_LIST_VIDEO_MODELS`
>
> List the pro AI video models this Memelord account can run, including each model's required inputs, optional inputs, rules, parameter options, ranges, and defaults. Call this before Run Video Model. This operation is free.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Free
>
> #### Input Parameters
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting, sent as a query parameter; never use an email address or name.
>
> **end\_user\_id\_header** `string`
>
> Opaque end-user ID for usage reporting, sent in the X-Memelord-End-User header; never use an email address or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Run Image Tool
>
> **Slug:** `MEMELORD_RUN_IMAGE_TOOL`
>
> Run one paid Memelord image tool by its catalog tool ID. Supply the image, prompt, and scalar tool-specific parameters required by that tool.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \~\$0.08 per run for most tools; depends on the tool you choose
>
> **Discount:** 100
>
> #### Input Parameters
>
> **params** `object`
>
> Tool-specific parameters keyed by catalog parameter key. Values must be strings, numbers, or booleans.
>
> **prompt** `string`
>
> Text input for text-to-image tools.
>
> **tool\_id** `string` *required*
>
> Tool ID returned by the image-tool catalog action.
>
> **image\_url** `string`
>
> Public input image URI for image-to-image tools.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting, sent in the JSON body; never send an email address or name.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID for usage reporting, sent in the X-Memelord-End-User header; never send an email address or name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Run Video Model
>
> **Slug:** `MEMELORD_RUN_VIDEO_MODEL`
>
> Start paid AI video generation using a model and valid parameters from List Video Models. Media inputs must be public URIs supplied by the user. Returns a job ID when processing starts; invalid\_request and needs\_input results do not start a job or incur a charge.
>
> #### Input Parameters
>
> **seed** `integer`
>
> Seed for reproducibility; supported by Wan only.
>
> **title** `string`
>
> Short title for the saved video.
>
> **prompt** `string` *required*
>
> Scene, action, camera, lighting, and motion to generate.
>
> **variant** `string`
>
> Model version or quality tier advertised by List Video Models.
>
> **duration** `integer`
>
> Generated length in seconds, within the selected model's advertised range.
>
> **model\_id** `string ("kling" | "kling-o3" | "seedance" | "wan" | "cinema-studio")` *required*
>
> Video model ID selected from List Video Models.
>
> **image\_url** `string`
>
> Public URI of the start or first-frame image for models that support it.
>
> **resolution** `string`
>
> One of the selected model's advertised resolution options.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting, sent in the request body; never use an email address or name.
>
> **aspect\_ratio** `string`
>
> One of the selected model's advertised aspect\_ratio options.
>
> **end\_image\_url** `string`
>
> Public URI of the last-frame image; requires image\_url.
>
> **generate\_audio** `boolean`
>
> Whether to generate a soundtrack, where supported by the selected model.
>
> **end\_user\_id\_header** `string`
>
> Opaque end-user ID for usage reporting, sent in the X-Memelord-End-User header; never use an email address or name.
>
> **reference\_audio\_urls** `array`
>
> Up to 5 public reference-audio URIs.
>
> **reference\_image\_urls** `array`
>
> Up to 10 public reference-image URIs, referred to as Image 1, Image 2, and so on in the prompt.
>
> **reference\_video\_urls** `array`
>
> Up to 5 public reference-clip URIs for motion or camera guidance.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Memes
>
> **Slug:** `MEMELORD_SEARCH_MEMES`
>
> Search Memelord's meme, video-clip, and sticker template library by meaning, text, misspelling, or similar media. Returns one provider-managed page.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** Free
>
> #### Input Parameters
>
> **tags** `array`
>
> Only return assets carrying any supplied tag.
>
> **type** `string ("meme" | "video" | "sticker")`
>
> Only return this asset type.
>
> **limit** `integer`
>
> Maximum results to return; the provider defaults to 20.
>
> **query** `string`
>
> Search text; required unless method is "semantic\_media".
>
> **method** `string ("semantic_context" | "semantic_combined" | "semantic_media" | "fulltext" | "fuzzy")`
>
> Search strategy. Omit for semantic\_context, use fulltext for exact names, fuzzy for misspellings, or semantic\_media with media\_url.
>
> **offset** `integer`
>
> Results to skip. For another page, pass the previous response's next\_offset while keeping all other search inputs unchanged.
>
> **media\_url** `string`
>
> Image or video URL used by the "semantic\_media" method.
>
> **min\_score** `number`
>
> Optional per-method relevance floor from 0 through 1.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting; never send an email address or name.
>
> **exclude\_ids** `array`
>
> Asset IDs to skip. Use only when starting a fresh search because adding them while paging shifts subsequent pages.
>
> **include\_nsfw** `boolean`
>
> Whether NSFW-tagged assets may be returned; the provider defaults to true.
>
> **face\_swappable** `boolean`
>
> Whether to return only templates with a swappable face.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID sent in X-Memelord-End-User instead of end\_user\_id; never send an email address or name.
>
> **template\_approved** `boolean`
>
> Whether to return only curator-approved templates.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Start Video Meme Edit
>
> **Slug:** `MEMELORD_START_VIDEO_MEME_EDIT`
>
> Start a paid asynchronous caption rewrite and video re-render. Provide a prior generation's template ID and caption, then poll the returned job ID with Check Video Status. Unlike Edit Video Meme, this action does not accept webhooks or audio overlays.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \~\$0.01 per edit
>
> **Discount:** 100
>
> #### Input Parameters
>
> **caption** `string` *required*
>
> Current caption text to edit.
>
> **end\_user\_id** `string`
>
> Opaque end-user ID for usage reporting in the request body; never use an email or name.
>
> **instruction** `string` *required*
>
> Plain-language instruction describing how to change the caption.
>
> **template\_id** `string` *required*
>
> Video template asset ID.
>
> **end\_user\_id\_header** `string`
>
> Opaque end-user ID for usage reporting in the request header; never use an email or name.
>
> **force\_caption\_style** `string ("top" | "tiktok")`
>
> Force top letterbox or centered-overlay TikTok captions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Swap Video Subject With Genjutsu
>
> **Slug:** `MEMELORD_SWAP_VIDEO_SUBJECT_WITH_GENJUTSU`
>
> Start a paid Genjutsu job that transposes people or characters, or swaps an object or creature, in an existing video while retaining its motion, camera, timing, and audio. Poll the returned job ID for completion.
>
> #### Input Parameters
>
> **mode** `string ("motion-transfer" | "object-swap")`
>
> Use motion-transfer to put a person into the clip, or object-swap to replace an object or creature. The provider defaults to motion-transfer.
>
> **title** `string`
>
> Short title for the saved video.
>
> **prompt** `string`
>
> Optional short direction in the user's words, such as wardrobe or lighting.
>
> **video\_url** `string`
>
> Public URL of the 4-30 second source clip; longer clips are trimmed. Use the URL returned by Memelord media upload for a local file.
>
> **characters** `array`
>
> People to recast in one generation, one entry per person. This takes precedence over character\_image\_urls.
>
> **resolution** `string ("720p" | "480p")`
>
> Output resolution; the provider defaults to 720p.
>
> **end\_user\_id** `string`
>
> Opaque ID of the end user behind this call for usage reporting; never send an email address or name.
>
> **video\_job\_id** `string`
>
> Job ID of a finished video on this account, used instead of video\_url.
>
> **end\_user\_header** `string`
>
> Opaque end-user ID sent in X-Memelord-End-User for usage reporting.
>
> **character\_image\_urls** `array`
>
> Up to 8 public photo URLs of one person or character, with a clear front-facing photo first. Use characters for several people.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
