# Gifu Random GIF/Image Search

> Gifu Random GIF/Image Search is a paid API for AI agents from gifu-server.onrender.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Returns a randomly selected GIF or image based on AI-generated creative prompts, sourced from Giphy, Tenor, and Klipy

## Facts

- Endpoint: POST https://gifu-server.onrender.com/api/x402/search/random
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gifu-server-onrender-com-4887bd1c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q5b5CUFDMcf5JR4z3jOQq

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gifu-server-onrender-com-4887bd1c -d '<json body>'
```

Example prompt: Surprise me with a random GIF — use AI to come up with a creative prompt and find something fun and unexpected from Giphy or Tenor.

## When to prefer this

Use this endpoint when you want a random, AI-curated GIF or image without specifying a particular topic, or when you want creative/unexpected results driven by AI prompt generation rather than a specific user keyword search. Prefer the sibling semantic search endpoint when you have a specific topic in mind.

## Known failure modes

- Payment not provided or insufficient USDC — returns 402 Payment Required
- No results found for AI-generated prompt — returns empty result set
- External GIF provider (Giphy/Tenor/Klipy) unavailable — returns 503 or error
- Invalid request body — returns 400 Bad Request
- Server timeout on render.com free tier cold start — returns 504 Gateway Timeout

## How this service works

AI-generated random GIF or image search with creative prompts

## Output

Returns a randomly selected GIF or image URL along with metadata such as title, source, and preview information, sourced from Giphy, Tenor, or Klipy using an AI-generated creative prompt.

## Example request

```json
{
 "mode": "gif",
 "max_results": 1
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "type": "string",
   "description": "Result type (default: gif)"
  },
  "max_results": {
   "type": "number",
   "description": "Maximum results (default 20)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "mode": {
  "type": "string"
 },
 "count": {
  "type": "number"
 },
 "query": {
  "type": "string"
 },
 "results": {
  "type": "array"
 },
 "sources": {
  "type": "array"
 },
 "success": {
  "type": "boolean"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gifu-server-onrender-com-4887bd1c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gifu-server.onrender.com](https://www.zero.xyz/host/gifu-server.onrender.com/llms.txt)