Get a random imageGet one random safe-for-work anime image with the artist's name and a link to the original artwork, ready to post with credit. Pick one of the image categories, or leave it empty for a neko. The address it returns is a direct link to the PNG, so it can go straight into a message or a web page. No API key required.
Get several random imagesGet up to twenty random anime images from one category in a single request, each with its artist's name and a link to the original artwork. Use this over drawing one at a time when a step needs a set: it costs one request against the per-category limit rather than one per image. No API key required.
Get a reaction GIFGet one random anime reaction GIF for a feeling or gesture, such as hug, pat, wave, facepalm or thumbsup, with the name of the anime it is taken from. There are about sixty reactions to choose from. The address it returns is a direct link to the GIF, so it can go straight into a chat message. No API key required.
Get several reaction GIFsGet up to twenty random reaction GIFs for one feeling or gesture in a single request, each with the anime it is taken from. Use this to offer a choice, or to fill a week of scheduled posts from one step rather than one request each. No API key required.
Search images and GIFsFind files by who made them: images are matched on the artist's name and GIFs on the title of the anime they are from, so 'Toradora' finds GIFs cut from Toradora! and an artist's name finds their drawings. Say which of the two you want, narrow to a category if you like, and take up to twenty at once. Nothing matching is an empty result, not a failed step. Search is the tightest-limited route the service has, at 7 requests per 5 seconds. No API key required.
List categoriesList every category the service offers, split into the image categories and the reaction GIF categories, each with the file format it serves and its address. This is the list the API asks callers to read rather than hard-code, so use it to pick a reaction at run time or to check one exists before asking for it. No API key required.
Look up a file by URLGet the credit for a file you already have the address of: the artist and a link to the original for an image, the anime for a GIF, plus the file's media type and size. The service keeps this in the file's own response headers, so the file is opened and closed without downloading it. For a workflow that stored an address earlier and wants to credit the artist when it posts. No API key required.
Download an image or GIFDownload a file so a later step can attach it to an email, upload it to a chat or put it in storage. Pass the address of a file from an earlier step for that exact one, or name a category to draw one at random and download it in the same step. The credit comes back with the file either way. The address alone is enough wherever a link will do; this is for the steps that need the bytes. No API key required.
Check service statusCheck whether nekos.best is answering and how quickly, without failing the step when it is not, and read how many requests are left in the current rate-limit window. Put this in front of a workflow and branch on 'ok', or use 'rate_limit_remaining' to slow a loop down before it is throttled rather than after. No API key required.
