---
name: gifu-server.onrender.com
description: gifu-server.onrender.com provides a single endpoint that returns a randomly-queried set of GIFs or images sourced from Giphy, Tenor, and Klipy. It uses AI-generated search queries internally to select results, and returns relevance scores alongside each result. No user-supplied search term is required.
host: gifu-server.onrender.com
---

# gifu-server.onrender.com

This host is a lightweight media-discovery service aimed at agents that need ambient or decorative GIF/image content without a specific keyword. It aggregates results from three external sources (Giphy, Tenor, Klipy) and handles query generation internally, returning a scored result set. It does not support deterministic asset retrieval or keyword-driven search.

## When to use this host

Use this host when an agent needs to surface GIFs or images without a user-supplied search term — for example, for icebreakers, ambient content, or decorative media fills. Do not use it when the user has a specific keyword or phrase to search; in that case use a keyword-driven API such as the Giphy or Tenor search endpoints directly. Do not use it when a single deterministic asset is needed by ID. Because this host has only one skill and no chaining capability, it is not suitable for multi-step media workflows.

## Capabilities

### Random Media Discovery

Fetches a randomly-queried batch of GIFs or images from multiple sources, with AI-generated queries and per-result relevance scores. Supports mode selection and result count control.

- **`fetch-random-gif-or-image`** — Returns a randomly-queried set of GIFs or images sourced from Giphy, Tenor, and Klipy, with AI-generated search queries and relevance scores per result.

## Skill reference

### `fetch-random-gif-or-image`

**Gifu Random AI GIF/Image Search** — Returns a randomly-queried set of GIFs or images sourced from Giphy, Tenor, and Klipy, with AI-generated search queries and relevance scores per result.

*Use when:* Use when an agent needs to surface a random GIF or image without a specific user-supplied search term, such as for ambient content, icebreakers, or decorative media in a response.

*Not for:* Do not use when the user has a specific search query in mind; use a keyword-driven image or GIF search API instead. Not suitable for retrieving a single deterministic asset by ID.

**Inputs:**

- `mode` (string) — Result type to return. Accepted values: 'gif' or 'image'. Defaults to 'gif'.
- `max_results` (number) — Maximum number of results to return. Defaults to 20.

**Returns:** Returns success=true, an AI-generated query string, a results array with url/title/score per item, a count, and a sources array listing the content providers queried.

**Example:** `GET https://gifu-server.onrender.com/api/x402/search/random?mode=gif&max_results=5`

---