Pixaven is a modern, GPU-powered image processing API.
We transform, enhance, adjust, crop, stylize, filter and watermark your images with blazing speed.

---

The official Ruby integration for the Pixaven API.

---

Documentation

See the Pixaven API docs.

Installation

$ gem install pixaven

Quick examples

Pixaven API enables you to provide your images for processing in two ways - by uploading them directly to the API (Image Upload) or by providing a publicly available image URL (Image Fetch).

You may also choose your preferred response method on a per-request basis. By default, the Pixaven API will return a JSON response with rich metadata pertaining to input and output images. Alternatively, you can use binary responses. When enabled, the API will respond with a full binary representation of the resulting (output) image. This Ruby integration exposes two convenience methods for interacting with binary responses: .toFile() and .toBuffer().

Image upload

Here is a quick example of uploading a local file for processing. It calls .toJSON() at a final step and instructs the API to return a JSON response.

require "pixaven"

# Pass your Pixaven API Key to the constructor
pix = Pixaven.new("your-api-key")

# Upload an image from disk, resize it to 100 x 75,
# automatically enhance, and adjust sharpness parameter.
# You'll find the full JSON metadata within the `meta` variable
err, meta = (
    client
        .upload("path/to/input.jpg")
        .resize(
            width: 100,
            height: 75
        )
        .auto(
            enhance: true
        )
        .adjust(
            unsharp: 10
        )
        .to_json()
)

abort(err) if err

Image fetch

If you already have your source visuals publicly available online, we recommend using Image Fetch by default. That way you only have to send a JSON payload containing image URL and processing steps. This method is also much faster than uploading a full binary representation of the image.

require "pixaven"

# Pass your Pixaven API Key to the constructor
pix = Pixaven.new("your-api-key")

# Provide a publicly available image URL with `.fetch()` method,
# apply Gaussian blur using PNG as the output format.
# We'll also use `.toFile()` method and stream the output image to disk
err, meta = pix
    .fetch("https://www.website.com/image.jpg")
    .filter(
        blur: (
            mode: "gaussian",
            value: 10
        }
    )
    .output(
        format: "png"
    )
    .to_file("path/to/output.png")

abort(err) if err

License

This software is distributed under the MIT License. See the LICENSE file for more information.