Last.fm Collage Generator API v2.1
=================================

Discover options
----------------
GET https://lastfm.riffology.co/api/options

This returns every supported format, dimension, typography system, background
preview, layout, content type, period, and label mode. Build clients from this
response instead of hard-coding selector values.

Generate a collage
------------------
GET https://lastfm.riffology.co/api

Parameters
----------
username      Required. Existing Last.fm username.
layout        collage or grid. Default: collage.
type          album or artist. Default: album.
time          7day, 1month, 3month, 6month, 12month, overall, specific_week.
columns       Grid columns from 2 to 10. Default: 5.
labels        none, top5, all (labels=none|top5|all). yes/no remain aliases.
format        square, instagram_portrait, social_feed, story, pinterest, landscape.
typography    editorial, modern, archive, analogue.
background    Use an ID returned by /api/options.
title         Optional custom title, up to 100 characters.
show_title    Boolean. Default: true.
show_details  Boolean. Default: true where the format supports a summary.
from / to     Unix timestamps required when time=specific_week.

Invalid selector values return HTTP 400 with a JSON error and accepted values.

Story example
-------------
https://lastfm.riffology.co/api?username=rj&layout=collage&type=album&time=1month&labels=top5&format=story&typography=analogue&background=analogue_print&show_details=true

Social Feed example
-------------------
https://lastfm.riffology.co/api?username=rj&layout=grid&columns=5&type=album&time=7day&labels=top5&format=social_feed&typography=modern&background=carbon_paper&title=My%20Listening%20Week

Specific week example
---------------------
https://lastfm.riffology.co/api?username=rj&time=specific_week&from=1785715200&to=1786320000&layout=collage&type=artist&labels=top5&format=story&typography=archive&background=archive_card

Output formats
--------------
square               1500 x 1500  Instagram, Facebook, Threads
instagram_portrait   1080 x 1440  Instagram feed
social_feed          1080 x 1350  Instagram and Facebook feeds
story                1080 x 1920  Instagram/Facebook Stories, TikTok
pinterest            1000 x 1500  Pinterest Pins
landscape            1200 x 628   LinkedIn and X

Notes
-----
- One-shot API requests do not pause for missing-art uploads.
- Generation time depends on Last.fm response time and artwork cache coverage.
- The response is image/jpeg with a format-aware filename.
- Public generated-image URLs are temporary. Download or share the returned
  JPEG rather than treating the job URL as permanent storage.