Static ad aspect ratios an image API can return: Sume's list

Sume's Image API normalizes aspect ratio to 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 1:2, 2:1, 1:4, 4:1, 1:8, 8:1, 9:21, and 21:9, or auto to let the provider choose. A given model only accepts the subset its catalog lists, so read supported_parameters before you pin one. Static ad batches such as Higgsfield Ads Studio's, which its changelog dated 2026-09-30 says run to 20 ads per product, need one ratio per batch, set deliberately.

Facts here come from Sume's Image API docs, read 2026-10-02.

Which ratios does the Image API accept?

The list above is the normalized vocabulary. It is not a promise that every model takes every value: a request that sets a value the model does not list is rejected with 400 unsupported_parameter. The docs example for Seedream 4.5 shows 1:1, 16:9, 9:16, 4:3, and 3:4 only.

What is special about 4:5?

The docs say 4:5 is Instagram portrait at 1080x1350, not 4:3, and that Banana Pro sends aspect_ratio: "4:5" with a native size of about 928x1152 at 1K. Exact 1080x1350 is a documented post-step through the job's target_pixels. So a model can match the ratio and still not hand you the final pixel size.

What about edits from a product photo?

On edit and image-to-image calls, the docs say to prefer aspect_ratio: "auto" to match the reference, and that omitting the field is not the same as auto. If your ad template needs a fixed ratio, set it explicitly and check the result.

How do I check a model first?

Call GET /v1/images/models and read each model's aspect_ratio enum. Then run one image before a batch. 20 ad variations from one product image uses a fixed 1:1 ratio for that reason.

If one creative must ship in several shapes, generate each shape as its own request rather than cropping one image, since a crop can cut the product or the headline. Record the ratio in the file name. For shapes outside a model's list, choose the nearest listed ratio and finish with a post-step, and view the final file at its real size before it goes out.