Developer REST API & Platform

Build with the FiFi Media

Anonym image hosting, video sharing, and automated animated GIF generation for your apps, bots, and forums.

FiFi API

1. Developer Authentication

Sign in to access your API key or register a new developer account.

Don't have an API key yet?

2. Interactive API Playground

Test Image upload, Video upload, or GIF generation live with your API key.

Live Playground Locked

Enter your email & password in Step 1 to generate an API key. Once registered, you can immediately test image, video, and GIF APIs right here!

3. Developer Integration Guides

POSThttps://fifi.pics/api/upload
Image Hosting (Catbox + ImgBB Redundancy)

Anonymous permanent and temporary image hosting with automated multi-cloud failover (Catbox + ImgBB lifejacket + Litterbox). Automatically returns direct URLs, forum BBCode ([img]...[/img]), Markdown, and HTML embed snippets.

ParamTypeDefaultDescription
fileFile-Image file to upload (PNG, JPG, GIF, WebP, SVG, BMP... up to 200 MB).
apiKeyString-Your personal API key (or send in X-API-Key HTTP header).
providerStringcatboxTarget cloud host: "catbox" (permanent with automatic fallback), "imgbb" (direct cloud), "cloudinary" (global CDN), or "local".
isTemporaryBooleanfalseSet to "true" for temporary auto-expiring upload via Litterbox (Catbox only).
timeString72hExpiration period if temporary ("1h", "12h", "24h", "72h").
formatStringjsonRequested response format: "json" (default full object), "sodiforum" ([img src=url]), "bbcode" ([img]url[/img]), "markdown", "html", or "url" (returns direct raw text).
Response JSON (default):
{
  "success": true,
  "url": "https://files.catbox.moe/abc123.png",
  "directUrl": "https://files.catbox.moe/abc123.png",
  "sodiforum": "[img src=https://files.catbox.moe/abc123.png]",
  "bbcode": "[img]https://files.catbox.moe/abc123.png[/img]",
  "markdown": "![image](https://files.catbox.moe/abc123.png)",
  "html": "<img src=\"https://files.catbox.moe/abc123.png\" alt=\"image\" />",
  "provider": "catbox"
}
provider: catbox | imgbb | cloudinary | litterbox — storage provider where file was saved.
🛡️ Multi-Cloud Failover: If Catbox experiences downtime or timeout, FiFi automatically diverts your upload to ImgBB and Cloudinary CDN.
curl -X POST \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -F "file=@photo.png" \
  -F "provider=catbox" \
  https://fifi.pics/api/upload
POSThttps://fifi.pics/api/fifigif
Video ➔ Optimized Animated GIF

Converts any video format (MP4, WebM, MOV, MKV, AVI, TS...) to an optimized animated GIF with guaranteed ≤ 5 MB file size. By default returns direct binary GIF stream (image/gif), or pass upload=true for a public Catbox / ImgBB / Cloudinary link!

ParamTypeDefaultDescription
fileFile-Video file to convert (multipart/form-data, max 150 MB). Accepts file or video.
urlString-Public direct URL to a remote video file on the web (no file upload required).
startNumber / String0Trim start time in seconds (e.g. 2.5 or "00:15"). Alias: from.
durationNumberMax 10sClip duration in seconds (e.g. 4.5). Alias: len.
endNumber / String-Trim end time in seconds (alternative to duration). Alias: to.
widthNumber / StringAutoTarget width in pixels (e.g. 360, 480 or "480x270"). Aliases: w, res.
compressionStringnormalPreset: low (HD), normal (balanced), extra, or max (ultra-lightweight).
maxSizeNumber (MB)5Strict file size ceiling in MB. FiFi compresses adaptively until it fits! Alias: max_mb.
fpsNumberAuto (12–15)Output frame rate (e.g. 10, 15, 20).
cropString-Crop region of source video: "x,y,w,h" in pixels or percent (e.g. "10%,10%,80%,80%"). Also accepts cropX, cropY, cropWidth, cropHeight.
uploadBooleanfalseIf true, uploads converted GIF to the cloud and returns public URL. Alias: fifi=1.
providerStringcatboxTarget cloud host when upload=true: catbox (default), imgbb, or cloudinary.
formatStringgif"gif" (raw binary stream) or "json" (metadata + link + dataUrl).
Delivery Modes:
1. 💾 Direct Binary Stream (Default): Returns raw binary image/gif. If upload=true is set, the public URL is placed in the response header: X-Fifi-Url: https://....
2. 🌐 JSON Mode (format=json): Returns JSON payload containing "url", "dataUrl", dimensions, and compression stats.
curl -X POST \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -F "file=@video.mp4" \
  -F "width=480" \
  -F "upload=true" \
  -F "provider=catbox" \
  -F "format=json" \
  https://fifi.pics/api/fifigif
POSThttps://fifi.pics/api/upload-video
Video Upload & Embed Hosting

Upload videos to the decentralized AnonMP4 cluster with instant iframe embed codes, custom titles, and watch pages at /v/[id].

ParamTypeDefaultDescription
fileFile-Video file to upload (MP4, WebM, MOV, MKV... chunked streaming).
titleStringFilenameTitle displayed on watch and embed pages.
descriptionString-Optional description for the video player.
curl -X POST \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -F "file=@video.mp4" \
  -F "title=My Cool Video" \
  https://fifi.pics/api/upload-video