NetEase Playlist Postcard Generator

This is a minimal MVP that reads a NetEase playlist URL and generates a printable postcard image. If the playlist data cannot be fetched, it falls back to mock data so the app is still usable.

Setup

python -m pip install -r requirements.txt

Usage

python app.py "https://music.163.com/playlist?id=123456" --style minimal --size standard --output output/postcard.png

Styles: minimal, retro, modern, emotional

Sizes: standard (148x100mm at 300dpi), wallpaper (1080x1920)

Web UI

python -m uvicorn webapp:app --host 127.0.0.1 --port 8000

Open http://127.0.0.1:8000 in your browser.

Model API

The UI lets you provide your own API base URL, key, and model name. The backend will call an OpenAI-compatible image endpoint. If your provider uses a different path, enter the full endpoint as the base URL (e.g. https://api.example.com/v1/images/generations).

If no API credentials are provided, the server will generate the postcard locally.

Output

Generated images are written to the output/ folder (created automatically).

Notes

• Network restrictions or NetEase anti-scraping may block playlist fetching. In that case the app uses mock data.
• The postcard renderer focuses on layout and print resolution. You can customize the design in app.py.