perchance-api

Unofficial Python API for Perchance.

Installation

To install this module, run the following command:

pip install perchance-api

Examples

Text generation

import asyncio
from perchance import TextGenerator

async def main():
    async with TextGenerator() as gen:
        prompt = "How far is the Moon?"

        async for chunk in gen.stream(prompt):
            print(chunk, end='')

asyncio.run(main())

The text generator drives the official Perchance embed in a browser so its anti-bot verification can complete. A browser window opens by default; pass TextGenerator(headless=True) to hide it (verification may then fail).

Image generation

import asyncio
from PIL import Image
from perchance import ImageGenerator

async def main():
    async with ImageGenerator() as gen:
        prompt = "Fantasy landscape"

        result = await gen.image(prompt, shape='landscape')
        binary = await result.download()
        image = Image.open(binary)
        image.show()

asyncio.run(main())

Credits

Originally created by eeemoonYurii as the perchance package. This fork (perchance-api) rewrites the API calls and adds the describe/streaming updates.