llm7_image

llm7_image is a minimal helper that calls the LLM7 image-generation endpoint and returns a final, ready-to-use image URL (either a CDN redirect or an inline data: URI). It performs parameter validation, handles redirects, and surfaces clear errors when the API says “no”.

Installation

pip install llm7-image

Quick start

from llm7_image import generate_image

TOKEN = "paste-your-token-here"          # Get a free token at https://token.llm7.io/

def main() -> None:
    prompt = "A beautiful landscape with mountains and a river."
    url = generate_image(prompt, token=TOKEN, w=800, h=600, model=2)
    print(url)                           # → https://wsrv.nl/?url=https://api.llm7.io/i/abc123.jpeg…

if __name__ == "__main__":
    main()

If the image is streamed directly (rare), the helper returns an inline Base64-encoded data: URI instead of a redirect URL, so you can drop it straight into an <img> tag.

Parameters

Invalid values raise ValueError. Non-2xx API responses raise GenerationError with the server’s message.

Why use this helper?

• Zero boilerplate – one call, one URL.
• Strict validation – catch mistakes before they hit the network.
• Friendly errors – clear messages instead of cryptic HTTP codes.
• Tiny footprint – only dependency is requests.

Contributing

Bug reports, ideas, and pull requests are welcome! Open an issue or PR on the GitHub repo.

License

llm7_image is released under the MIT License.