ImageGen

An API Key is required for this service (it must have the "ImageGen" service flag). See Shared Responses for common error responses.

Meme and image generation - avatar compositing, text overlays, and a handful of video/gif effects. Successful requests return the generated file directly (as image/png, image/jpeg, image/gif, or video/mp4 depending on the endpoint) rather than a JSON envelope.

List Endpoints

GET https://imgen.yiff.rest/endpoints.json

Returns every currently available endpoint and its parameters. This is the authoritative, always-up-to-date list - the table further down this page is a convenience snapshot and can drift out of date.

{
  "endpoints": [
    {
      "name": "dab",
      "parameters": ["avatar0"]
    }
  ]
}

Generate

GET POST https://imgen.yiff.rest/api/{endpoint}

Endpoint-specific parameters (see the table below) are on top of the common ones listed here. GET requests take everything as query string parameters; POST requests take a JSON body instead, and use array keys (avatars/usernames) rather than numbered ones.

{
  "success": false,
  "code": 1090,
  "error": "Endpoint whatever not found!"
}

{
  "success": false,
  "code": 1092,
  "error": "..."
}

Endpoints