Developer REST API & Platform

Build with the FiFi Media

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

1. Developer Authentication

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)

High-speed 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.

Param	Type	Default	Description
file	File	-	Image file to upload (PNG, JPG, GIF, WebP, SVG, BMP... up to 200 MB).
apiKey	String	-	Your personal API key (or send in `X-API-Key` HTTP header).
isTemporary	Boolean	false	Set to "true" for temporary auto-expiring upload via Litterbox.
time	String	72h	Expiration period if temporary ("1h", "12h", "24h", "72h").

Response JSON:

{
  "success": true,
  "url": "https://files.catbox.moe/abc123.png",
  "directUrl": "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"
}

curl -X POST \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -F "file=@photo.png" \
  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 binary GIF, or pass upload=true for a public Catbox / ImgBB URL.

Param	Type	Default	Description
file	File	-	Video file to convert (multipart/form-data, max 150 MB).
url	String	-	Direct URL to a video file on the web (alternative to file upload).
start / from	Number	0	Start cut timestamp in seconds (or "00:15").
duration / len	Number	Max 10s	Clip duration in seconds.
width / res	Number	Auto	Target resolution width in pixels (e.g. 360, 480).
compression	String	normal	Preset: low (HD), normal, extra, or max (ultra-lightweight).
upload	Boolean	false	If true, uploads to Catbox with ImgBB fallback and returns public link.
format	String	gif	"gif" (binary image stream) or "json" (metadata + link + dataUrl).

curl -X POST \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -F "file=@video.mp4" \
  -F "width=480" \
  -F "upload=true" \
  -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].

Param	Type	Default	Description
file	File	-	Video file to upload (MP4, WebM, MOV, MKV... chunked streaming).
title	String	Filename	Title displayed on watch and embed pages.
description	String	-	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