YIFFYAPI IMGEN
HOME
STATISTICS
DOCUMENTATION
DASHBOARD

Contents

Endpoints Authorization Rate Limits

Endpoints

All endpoints require an Authorization header containing your key. You can request a key on the dashboard!


All endpoints also support POST requests with JSON data. These use arrays, so use {"avatars": [], "usernames": [], "text": "hi"}

GET http://imgen.yiff.rest/api/abandon

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/aborted

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/affect

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/airpods

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/america

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/armor

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/balloon

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/bed

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
avatar2: Image URL. Used when two users are involved. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/bongocat

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/boo

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/brain

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/brazzers

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/byemom

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
username1: String. Username for the first user.
text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/cancer

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/changemymind

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/cheating

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/citation

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/communism

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/confusedcat

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/corporate

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/crab

Details:


This endpoint returns an MP4 file. Make sure your application knows how to handle this format.
Malformed requests count against your ratelimit for this endpoint.
Separate text with a comma.

Rate Limit

1 request per 30 seconds

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/cry

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/dab

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/dank

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/deepfry

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/delete

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/disability

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/doglemon

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/door

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/egg

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/emergencymeeting

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/excuseme

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/expanddong

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/expandingwwe

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/facts

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/failure

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/fakenews

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/farmer

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/fedora

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/floor

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/fuck

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/garfield

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.
avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/gay

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/godwhy

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/goggles

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/hitler

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/humansgood

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/inator

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/invert

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/ipad

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/jail

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/justpretending

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/keepurdistance

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/kimborder

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/knowyourlocation

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/kowalski

Details:


This endpoint returns an MP4 file. Make sure your application knows how to handle this format.
Malformed requests count against your ratelimit for this endpoint.
Separate text with a comma.

Rate Limit

1 request per 30 seconds

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/laid

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/letmein

Details:


This endpoint returns an MP4 file. Make sure your application knows how to handle this format.
Malformed requests count against your ratelimit for this endpoint.

Rate Limit

1 request per 30 seconds

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/lick

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/madethis

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
avatar2: Image URL. Used when two users are involved. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/magik

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/master

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/meme

Details:


This endpoint works a bit differently from the other endpoints.
This endpoint takes in top_text and bottom_text parameters instead of text.
It also supports color and font parameters.
Fonts supported are: arial, arimobold, impact, robotomedium, robotoregular, sans, segoeuireg, tahoma and verdana.
Colors can be defined with HEX codes or web colors, e.g. black, white, orange etc. Try your luck ;)
The default is Impact in white

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
top_text: Endpoint specific parameter
bottom_text: Endpoint specific parameter
color: Endpoint specific parameter
font: Endpoint specific parameter

GET http://imgen.yiff.rest/api/note

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/nothing

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/obama

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/ohno

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/piccolo

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/plan

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/presentation

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/quote

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
username1: String. Username for the first user.
text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/radialblur

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/rip

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/roblox

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/salty

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/satan

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/savehumanity

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/screams

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
avatar2: Image URL. Used when two users are involved. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/shit

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/sickban

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/slap

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
avatar2: Image URL. Used when two users are involved. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/slapsroof

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/sneakyfox

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/spank

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
avatar2: Image URL. Used when two users are involved. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/stroke

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/surprised

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/sword

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.
username1: String. Username for the first user.

GET http://imgen.yiff.rest/api/theoffice

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/thesearch

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/trash

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/trigger

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/tweet

Details:


Note: You can actually use username2 as a way to set the @handle separately from the name

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
username1: String. Username for the first user.
text: String. Text to show on the generated image.
username2: String. Username for the second user.
altstyle: Endpoint specific parameter

GET http://imgen.yiff.rest/api/ugly

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/unpopular

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/violence

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/violentsparks

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/vr

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/walking

Rate Limit

5 requests per second

Supported Query Parameters:

text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/wanted

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/warp

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/whodidthis

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!

GET http://imgen.yiff.rest/api/whothisis

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
text: String. Text to show on the generated image.

GET http://imgen.yiff.rest/api/yomomma

Details:


This endpoint only returns a yo momma joke. No parameters are required.

Rate Limit

5 requests per second

Supported Query Parameters:

GET http://imgen.yiff.rest/api/youtube

Rate Limit

5 requests per second

Supported Query Parameters:

avatar1: Image URL. Usually a Discord Avatar. Supports at least JPG, PNG and BMP!
username1: String. Username for the first user.
text: String. Text to show on the generated image.

Authorization

All requests must be made with an authorization header that includes your API key! If you don't have a key, request one on the dashboard.

Example:

{"Authorization": "tokengoeshere"}

Rate Limits

Each endpoint has it's own ratelimit, which you can find in it's documentation. Additionally, the API has a global ratelimit of 300 requests per minute.

The ratelimits for the endpoint are defined with X-RateLimit-:key, while the global ratelimit is defined with X-Global-RateLimit-:key.
When the global ratelimit is hit, the body will contain an additional JSON key "global" which will be set to true.

Ratelimit Headers:

  • X-RateLimit-Limit: Maximum usage allowed per timeframe
  • X-Ratelimit-Remaining: Remaining requests that can be made during the timeframe
  • X-RateLimit-Reset: Timestamp indicating when the ratelimit will reset in milliseconds.
  • Retry-After: Time to wait in milliseconds until another request can be made. Only exposed if ratelimit is reached.
  • X-Global-RateLimit-Limit: Maximum global usage allowed per timeframe
  • X-Global-Ratelimit-Remaining: Remaining requests that can be made globally during the timeframe
  • X-Global-RateLimit-Reset: Timestamp indicating when the global ratelimit will resett in milliseconds.
  • Retry-After: Time to wait in milliseconds until another request can be made. Only exposed if ratelimit is reached.