Memelord API

Generate memes, edit images, and more!

Memes API has been deprecated in favor of the 🐸 AIKEK Memelord, our new method of delivering our Universal Agents and Fractal data infra to B2B.

Pipelines

---

Our Memes API provides access to all of our Graphic Pipelines: Text-to-Image, Effect, and Mirage. Read about Authentification if that's your first time using Alphakek API.

Input image requirements: PNG or JPG format, size under 2MB

Create an image from a text prompt

post

Create an image from a text prompt

Authorizations

Header parameters

turnstile-authorizationany ofOptional

stringOptional

or

nullOptional

Body

promptstringRequired

seedintegerOptional

widthinteger · min: 512 · max: 1280OptionalDefault: 1280

heightinteger · min: 512 · max: 1280OptionalDefault: 800

allow_nsfwbooleanRequired

Responses

200

Image file in PNG format

image/png

401

Insufficient credits

422

Validation Error

application/json

500

Failed to apply effect. Your credits were refunded.

post

HTTPcURLJavaScriptPython

POST /visuals/create_image HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 70

{
  "prompt": "text",
  "seed": 1,
  "width": 1280,
  "height": 800,
  "allow_nsfw": true
}

No content

Code examples in the next two widgets are WRONG! There seems to be a bug on GitBook's side. Refer to Sending form-data requests for the correct code snippet.

Apply an effect to an image

post

Apply an effect to an image

Authorizations

Header parameters

turnstile-authorizationany ofOptional

stringOptional

or

nullOptional

Body

imagestring · binaryRequired

promptstringRequired

seedintegerOptional

allow_nsfwbooleanOptionalDefault: false

Responses

200

Image file in PNG format

image/png

401

Insufficient credits

422

Validation Error

application/json

500

Failed to apply effect. Your credits were refunded.

post

HTTPcURLJavaScriptPython

POST /visuals/apply_effect HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 62

{
  "image": "binary",
  "prompt": "text",
  "seed": 1,
  "allow_nsfw": false
}

No content

Sending form-data requests

/visuals/apply_effect and /visuals/appy_mirage are using multipart/form-data format. Imagine you have a file named selfie.png. In this case, you'll need to call the following code:

Python

import requests  # Run `pip install requests` if you haven't installed it yet

url = 'https://api.alphakek.ai/visuals/apply_effect'
headers = {
    'accept': 'application/json',
    'Authorization': 'Bearer XXXXX'  # Replace with your API key
}
files = {
    'image': ('selfie.png', open('selfie.png', 'rb'), 'image/png')
}
data = {
    'prompt': 'scary clown',  # modifty these parameters as needed
    'seed': '123456',
    'allow_nsfw': 'true'
}

response = requests.post(url, headers=headers, files=files, data=data)

if response.status_code == 200:
    with open('output.png', 'wb') as f:
        f.write(response.content)
else:
    print(f"Failed with status code {response.status_code}")
    print(response.text)

JavaScript

// Run `npm install axios form-data` before executing this script
import axios from 'axios';
import FormData from 'form-data';
import fs from 'fs';

const url = 'https://api.alphakek.ai/visuals/apply_effect';
const headers = {
    'accept': 'application/json',
    'Authorization': 'Bearer XXXXXXXXX'  // Replace with your API key
};

const formData = new FormData(); // Replace with your image and parameters
formData.append('image', fs.createReadStream('selfie.png'), 'selfie.png');
formData.append('prompt', 'scary clown');
formData.append('seed', '123456');
formData.append('allow_nsfw', 'true');

// Combine headers
const config = {
    headers: {
        ...headers,
        ...formData.getHeaders() // Required to set the proper Content-Type for multipart/form-data
    },
    responseType: 'arraybuffer' // Necessary to handle binary data
};

axios.post(url, formData, config)
    .then(response => {
        if (response.status === 200) {
            fs.writeFileSync('output.png', response.data);
            console.log('File saved as output.png');
        } else {
            console.error(`Failed with status code ${response.status}`);
        }
    })
    .catch(error => {
        console.error('There was a problem with the request:', error);
    });

Chat API Costs

---

Each API call costs 1 credit. Read more at API Pricing.