Docs
Open Lodol
DocumentationIntegrationsAPI

AI Cats

App · Images & Design · 9 actions

Pull AI-generated cat pictures and short cat videos into a workflow: a random one to post, a batch to build a gallery from, or a search over the library by what the cat looks like. Every cat carries the prompt it was generated from, its theme and a link at any size from a 16px avatar to a 1024px picture, and both the random pick and any cat by id can be downloaded as a file to attach or upload. Ten themes, most of them seasonal, so a scheduled workflow can post a cat that suits the day: pumpkins in October, snow in December. No account or API key required.

Actions

ActionWhat it does
Complete a search termFinish a half-typed search term using the library's own vocabulary, so a search box can suggest as someone types, or a workflow can turn a rough phrase into one that will match.
Count catsCount the cats in the library, optionally for one theme or just the videos: the check for a step that reports how much there is to draw on before it starts.
Download a catDownload one cat's picture or video by its id, so a later step can attach it, post it or store it.
Download a random catDownload a random cat picture or video as a file, so a later step can post it to a chat, attach it to an email or put it in storage.
Get a catGet one cat's details by its id: the prompt it was generated from, its theme, whether it is a picture or a video, when it was made, and a link at the size you ask for.
Get random catsGet a batch of random cats as ids and links rather than files: for a gallery, a digest, or picking one cat to look up or download next.
Get similar catsGet the cats that look like one cat: pick a cat someone liked and pull more in the same vein.
List themesList every theme the library can be filtered by, as the service reports it today.
Search catsFind cats by what they look like, searching the prompts they were generated from.

Complete a search term

Finish a half-typed search term using the library's own vocabulary, so a search box can suggest as someone types, or a workflow can turn a rough phrase into one that will match. No API key required.

Inputs

Search textquerytext
Optional. What the cat should look like, in plain words. The library is searched on the prompts the cats were generated from, so describe the picture rather than naming a file. Leave blank to browse everything that matches the filters.
Start afterfrom_cat_idtext
Optional. A cat id to carry on from, for walking a long result set. Pass the next-from id the previous run reported. Leave blank to start at the beginning.
Themethemetext
Optional. Only cats from this theme. Any theme by default. The seasonal ones are how a scheduled workflow posts a cat that suits the day: Halloween in October, Xmas in December. Run List themes for the set the service currently holds.One of: All (Any theme), Default, Spring, Summer, Autumn, Winter, Halloween, Xmas (Christmas), NewYear (New Year), Easter, Mystical. Default: All.
Pictures or videosmedia_typetext
Optional. Whether to return pictures, videos or both. Pictures only by default, which is what the service itself defaults to. Choose videos only where the next step can take an MP4.One of: All (Pictures and videos), Image (Pictures only), Video (Videos only). Default: Image.
Newest firstdescendingtrue/false
Optional. Return the most recently generated cats first. Off by default.Default: false.

Outputs

completiontext
The suggested term, e.g. 'fluffy orange'. Null when the service had nothing to suggest.
has_completiontrue/false
True when a suggestion came back. Branch on this rather than testing the text for emptiness.
querytext
The half-typed text that was completed. Null when it was left blank.
Example output
{
  "completion": "fluffy orange",
  "has_completion": true,
  "query": "fluffy or"
}

Count cats

Count the cats in the library, optionally for one theme or just the videos: the check for a step that reports how much there is to draw on before it starts. No API key required.

Inputs

Themethemetext
Optional. Only cats from this theme. Any theme by default. The seasonal ones are how a scheduled workflow posts a cat that suits the day: Halloween in October, Xmas in December. Run List themes for the set the service currently holds.One of: All (Any theme), Default, Spring, Summer, Autumn, Winter, Halloween, Xmas (Christmas), NewYear (New Year), Easter, Mystical. Default: All.
Pictures or videosmedia_typetext
Optional. Whether to return pictures, videos or both. Pictures only by default, which is what the service itself defaults to. Choose videos only where the next step can take an MP4.One of: All (Pictures and videos), Image (Pictures only), Video (Videos only). Default: Image.

Outputs

countnumber
How many cats match the theme and media type.
media_typetext
The media type that was filtered on: 'All', 'Image' or 'Video'.
themetext
The theme that was filtered on, or 'All' when none was.
Example output
{
  "count": 125000,
  "media_type": "Image",
  "theme": "All"
}

Download a cat

Download one cat's picture or video by its id, so a later step can attach it, post it or store it. Use this after a search, when a link will not do and the file itself has to travel with the message. No API key required.

Inputs

Cat idcat_idtextRequired
The id of the cat to download. Every cat a search, a similar-cats lookup or a batch of random cats returns carries one.
Sizesizetext
Optional. How large the picture or video should be, in pixels square. 1024 by default; the small sizes are for thumbnails and avatars.One of: 16 (16 x 16), 32 (32 x 32), 64 (64 x 64), 128 (128 x 128), 256 (256 x 256), 512 (512 x 512), 1024 (1024 x 1024). Default: 1024.

Outputs

byte_sizenumber
The file's size in bytes.
catobject
One cat, and everything AI Cats publishes about it.
content_typetext
The file's media type, e.g. image/jpeg or video/mp4.
document_reftext
The stored document's reference.
documentslist
The downloaded cat as a document, ready to attach to a later step.
media_typetext
The media type that was filtered on: 'All', 'Image' or 'Video'.
sizetext
The size, in pixels, the links and files were rendered at.
themetext
The theme that was filtered on, or 'All' when none was.
urltext
A URL that serves the stored file.
Example output
{
  "byte_size": 141653,
  "cat": {
    "blur_hash": "eIH24T?b0KD$IV?^-poJkWjFwuNKxu%2t7%MxaoLWBkCt,t7V@WBs,",
    "created_at": "2024-08-07T00:26:43.629000+00:00",
    "date_created": 1722990403629,
    "id": "ffd962f8-55fa-4f2d-b00d-e067e56211bb",
    "prompt": "In a peaceful conservatory with a variety of exotic plants on a warm night with the air filled with the scent of summer exploring a secluded area a fluffy Ragamuffin cat with a soft coat with a delicate lace collar, with the scent of fresh oranges.",
    "theme": "Default",
    "type": "Image",
    "url": "https://api.ai-cats.net/v2/cat/ffd962f8-55fa-4f2d-b00d-e067e56211bb.jpg?size=1024"
  },
  "content_type": "image/jpeg",
  "document_ref": "doc_21ad8065bfb74ae184d940de471747a9",
  "documents": [
    {
      "content_type": "image/jpeg",
      "document_ref": "doc_21ad8065bfb74ae184d940de471747a9",
      "filename": "ai-cats-ffd962f8-55fa-4f2d-b00d-e067e56211bb.jpg",
      "size_bytes": 141653,
      "url": "/actions/core/serve-document/doc_21ad8065bfb74ae184d940de471747a9"
    }
  ],
  "media_type": "Image",
  "size": "1024",
  "theme": "Default",
  "url": "/actions/core/serve-document/doc_21ad8065bfb74ae184d940de471747a9"
}

Download a random cat

Download a random cat picture or video as a file, so a later step can post it to a chat, attach it to an email or put it in storage. Filter by theme for a cat that suits the season. No API key required.

Inputs

Sizesizetext
Optional. How large the picture or video should be, in pixels square. 1024 by default; the small sizes are for thumbnails and avatars.One of: 16 (16 x 16), 32 (32 x 32), 64 (64 x 64), 128 (128 x 128), 256 (256 x 256), 512 (512 x 512), 1024 (1024 x 1024). Default: 1024.
Themethemetext
Optional. Only cats from this theme. Any theme by default. The seasonal ones are how a scheduled workflow posts a cat that suits the day: Halloween in October, Xmas in December. Run List themes for the set the service currently holds.One of: All (Any theme), Default, Spring, Summer, Autumn, Winter, Halloween, Xmas (Christmas), NewYear (New Year), Easter, Mystical. Default: All.
Pictures or videosmedia_typetext
Optional. Whether to return pictures, videos or both. Pictures only by default, which is what the service itself defaults to. Choose videos only where the next step can take an MP4.One of: All (Pictures and videos), Image (Pictures only), Video (Videos only). Default: Image.

Outputs

byte_sizenumber
The file's size in bytes.
content_typetext
The file's media type, e.g. image/jpeg or video/mp4.
document_reftext
The stored document's reference.
documentslist
The downloaded cat as a document, ready to attach to a later step.
media_typetext
The media type that was filtered on: 'All', 'Image' or 'Video'.
sizetext
The size, in pixels, the links and files were rendered at.
themetext
The theme that was filtered on, or 'All' when none was.
urltext
A URL that serves the stored file.
Example output
{
  "byte_size": 141653,
  "content_type": "image/jpeg",
  "document_ref": "doc_21ad8065bfb74ae184d940de471747a9",
  "documents": [
    {
      "content_type": "image/jpeg",
      "document_ref": "doc_21ad8065bfb74ae184d940de471747a9",
      "filename": "ai-cats-random.jpg",
      "size_bytes": 141653,
      "url": "/actions/core/serve-document/doc_21ad8065bfb74ae184d940de471747a9"
    }
  ],
  "media_type": "Image",
  "size": "1024",
  "theme": "All",
  "url": "/actions/core/serve-document/doc_21ad8065bfb74ae184d940de471747a9"
}

Get a cat

Get one cat's details by its id: the prompt it was generated from, its theme, whether it is a picture or a video, when it was made, and a link at the size you ask for. No API key required.

Inputs

Cat idcat_idtextRequired
The id of the cat to look up. Every cat a search, a similar-cats lookup or a batch of random cats returns carries one.
Sizesizetext
Optional. How large the link should be, in pixels square. 1024 by default; the small sizes are for thumbnails and avatars.One of: 16 (16 x 16), 32 (32 x 32), 64 (64 x 64), 128 (128 x 128), 256 (256 x 256), 512 (512 x 512), 1024 (1024 x 1024). Default: 1024.

Outputs

catobject
One cat, and everything AI Cats publishes about it.
Example output
{
  "cat": {
    "blur_hash": "eIH24T?b0KD$IV?^-poJkWjFwuNKxu%2t7%MxaoLWBkCt,t7V@WBs,",
    "created_at": "2024-08-07T00:26:43.629000+00:00",
    "date_created": 1722990403629,
    "id": "ffd962f8-55fa-4f2d-b00d-e067e56211bb",
    "prompt": "In a peaceful conservatory with a variety of exotic plants on a warm night with the air filled with the scent of summer exploring a secluded area a fluffy Ragamuffin cat with a soft coat with a delicate lace collar, with the scent of fresh oranges.",
    "theme": "Default",
    "type": "Image",
    "url": "https://api.ai-cats.net/v2/cat/ffd962f8-55fa-4f2d-b00d-e067e56211bb.jpg?size=1024"
  }
}

Get random cats

Get a batch of random cats as ids and links rather than files: for a gallery, a digest, or picking one cat to look up or download next. No API key required.

Inputs

Number of catslimitnumber
Optional. How many cats to return. Between 1 and 100; 10 by default.From 1 to 100. Default: 10.
Sizesizetext
Optional. How large each link should be, in pixels square. 1024 by default; the small sizes are for thumbnails and avatars.One of: 16 (16 x 16), 32 (32 x 32), 64 (64 x 64), 128 (128 x 128), 256 (256 x 256), 512 (512 x 512), 1024 (1024 x 1024). Default: 1024.
Themethemetext
Optional. Only cats from this theme. Any theme by default. The seasonal ones are how a scheduled workflow posts a cat that suits the day: Halloween in October, Xmas in December. Run List themes for the set the service currently holds.One of: All (Any theme), Default, Spring, Summer, Autumn, Winter, Halloween, Xmas (Christmas), NewYear (New Year), Easter, Mystical. Default: All.
Pictures or videosmedia_typetext
Optional. Whether to return pictures, videos or both. Pictures only by default, which is what the service itself defaults to. Choose videos only where the next step can take an MP4.One of: All (Pictures and videos), Image (Pictures only), Video (Videos only). Default: Image.

Outputs

catslist
The cats in this batch.
countnumber
How many cats came back in this batch.
media_typetext
The media type that was filtered on: 'All', 'Image' or 'Video'.
sizetext
The size, in pixels, the links and files were rendered at.
themetext
The theme that was filtered on, or 'All' when none was.
Example output
{
  "cats": [
    {
      "blur_hash": "eUHLSLaeI9X8M{~ps:IooLM|s;WVs:oyadkWf+j?WCkBt7jskCj[WB",
      "created_at": null,
      "date_created": null,
      "id": "08f421a0-3940-4795-ada1-2f6495b8669f",
      "prompt": null,
      "theme": null,
      "type": "Image",
      "url": "https://api.ai-cats.net/v2/cat/08f421a0-3940-4795-ada1-2f6495b8669f.jpg?size=1024"
    }
  ],
  "count": 1,
  "media_type": "Image",
  "size": "1024",
  "theme": "All"
}

Get similar cats

Get the cats that look like one cat: pick a cat someone liked and pull more in the same vein. No API key required.

Inputs

Cat idcat_idtextRequired
The id of the cat to find lookalikes for. Every cat a search, a similar-cats lookup or a batch of random cats returns carries one.
Number of catslimitnumber
Optional. How many cats to return. Between 1 and 100; 10 by default. The service has been seen to hand back one more than it was asked for here, so read the count rather than assuming.From 1 to 100. Default: 10.
Sizesizetext
Optional. How large each link should be, in pixels square. 1024 by default; the small sizes are for thumbnails and avatars.One of: 16 (16 x 16), 32 (32 x 32), 64 (64 x 64), 128 (128 x 128), 256 (256 x 256), 512 (512 x 512), 1024 (1024 x 1024). Default: 1024.

Outputs

cat_idtext
The cat the lookalikes were found for.
catslist
The lookalike cats, closest first.
countnumber
How many cats came back in this batch.
has_moretrue/false
True when the service filled the batch, so there are probably more lookalikes than were asked for. There is no cursor here: raise Number of cats to see further down the list.
Example output
{
  "cat_id": "ffd962f8-55fa-4f2d-b00d-e067e56211bb",
  "cats": [
    {
      "blur_hash": "eUHLSLaeI9X8M{~ps:IooLM|s;WVs:oyadkWf+j?WCkBt7jskCj[WB",
      "created_at": null,
      "date_created": null,
      "id": "08f421a0-3940-4795-ada1-2f6495b8669f",
      "prompt": null,
      "theme": null,
      "type": "Image",
      "url": "https://api.ai-cats.net/v2/cat/08f421a0-3940-4795-ada1-2f6495b8669f.jpg?size=1024"
    }
  ],
  "count": 1,
  "has_more": true
}

List themes

List every theme the library can be filtered by, as the service reports it today. The themes are mostly seasonal, so this is what a workflow reads before deciding which one suits the date. No API key required.

Inputs

None.

Outputs

countnumber
How many themes there are.
themeslist
The theme names, exactly as the Theme filter on every other action expects them.
Example output
{
  "count": 5,
  "themes": [
    "All",
    "Default",
    "Winter",
    "Xmas",
    "NewYear"
  ]
}

Search cats

Find cats by what they look like, searching the prompts they were generated from. Filter by theme and by pictures or videos, sort newest first, and walk long results a batch at a time. No API key required.

Inputs

Search textquerytext
Optional. What the cat should look like, in plain words. The library is searched on the prompts the cats were generated from, so describe the picture rather than naming a file. Leave blank to browse everything that matches the filters.
Number of catslimitnumber
Optional. How many cats to return. Between 1 and 100; 10 by default.From 1 to 100. Default: 10.
Start afterfrom_cat_idtext
Optional. A cat id to carry on from, for walking a long result set. Pass the next-from id the previous run reported. Leave blank to start at the beginning.
Sizesizetext
Optional. How large each link should be, in pixels square. 1024 by default; the small sizes are for thumbnails and avatars.One of: 16 (16 x 16), 32 (32 x 32), 64 (64 x 64), 128 (128 x 128), 256 (256 x 256), 512 (512 x 512), 1024 (1024 x 1024). Default: 1024.
Themethemetext
Optional. Only cats from this theme. Any theme by default. The seasonal ones are how a scheduled workflow posts a cat that suits the day: Halloween in October, Xmas in December. Run List themes for the set the service currently holds.One of: All (Any theme), Default, Spring, Summer, Autumn, Winter, Halloween, Xmas (Christmas), NewYear (New Year), Easter, Mystical. Default: All.
Pictures or videosmedia_typetext
Optional. Whether to return pictures, videos or both. Pictures only by default, which is what the service itself defaults to. Choose videos only where the next step can take an MP4.One of: All (Pictures and videos), Image (Pictures only), Video (Videos only). Default: Image.
Newest firstdescendingtrue/false
Optional. Return the most recently generated cats first. Off by default.Default: false.

Outputs

catslist
The matching cats in this batch.
countnumber
How many cats came back in this batch.
has_moretrue/false
True when the batch came back full, so there are probably more cats to fetch.
media_typetext
The media type that was filtered on: 'All', 'Image' or 'Video'.
next_from_idtext
The id to pass as Start after to fetch the next batch. Null when this was the last one.
querytext
The text that was searched for. Null when the search was left blank.
sizetext
The size, in pixels, the links and files were rendered at.
themetext
The theme that was filtered on, or 'All' when none was.
Example output
{
  "cats": [
    {
      "blur_hash": "eUHLSLaeI9X8M{~ps:IooLM|s;WVs:oyadkWf+j?WCkBt7jskCj[WB",
      "created_at": null,
      "date_created": null,
      "id": "08f421a0-3940-4795-ada1-2f6495b8669f",
      "prompt": null,
      "theme": null,
      "type": "Image",
      "url": "https://api.ai-cats.net/v2/cat/08f421a0-3940-4795-ada1-2f6495b8669f.jpg?size=1024"
    }
  ],
  "count": 1,
  "has_more": false,
  "media_type": "Image",
  "next_from_id": null,
  "query": "orange fluffy cat",
  "size": "1024",
  "theme": "All"
}

Agify

Previous Page

Airparser

Next Page

On this page

ActionsComplete a search termCount catsDownload a catDownload a random catGet a catGet random catsGet similar catsList themesSearch cats