Ad image ratios for LinkedIn, Pinterest, X and the Sume ratio to ask

Ask Sume for 2:3 for a Pinterest image pin, 1:1 or a cropped 2:1 for an X image card, and 3:1 for LinkedIn's Lead Gen Form image. The targets come from Pinterest's ad specs, X's Creatives documentation and LinkedIn's Lead Gen Form specifications; the ratio values Sume accepts are listed per model in its Image API.

Side by side

Crop math in one function

When the ratio you need is not offered, request the nearest wider one and center-crop. This returns the box to crop to.

def center_crop_box(w: int, h: int, target: float) -> tuple[int, int, int, int]:
    if w / h > target:
        new_w = round(h * target)
        left = (w - new_w) // 2
        return (left, 0, left + new_w, h)
    new_h = round(w / target)
    top = (h - new_h) // 2
    return (0, top, w, top + new_h)

print(center_crop_box(3000, 1000, 552 / 200))
print(center_crop_box(2000, 1000, 1.91))

Check the model's list first

Ratio lists differ by model, so call GET /v1/images/models and read aspect_ratio for the one you use.