Skip to main content
A Creative Session makes each image at one size. When the draft names no size, that size is 1024×1024 unless the draft’s destination needs another. Many destinations do: Meta’s feed image must be at least 1080 pixels wide, so a 1024×1024 image does not fit Meta. This page lists the sizes a session can make, how a draft’s starting size is chosen, how to see which sizes your destination accepts, and how to choose one.

The sizes

Every image comes out at exactly the size you ask for, whichever engine makes it: when an engine works at a nearby ratio, Apostra crops the result to your size, keeping the part most likely to hold the subject. A Meta image post picks its own size when the draft names none: 1080×1350 (4:5), or another of Meta’s feed ratios when the campaign’s placement calls for it.

What a size costs

The size does not change what Apostra charges. Images made with the Apostra-funded engine carry no retail IU charge at any size (see Creative generation). The Gemini tier is Gemini’s own billing tier: Gemini bills an image up to 1024 pixels on its longer side at its 1K tier, and a larger one at its 2K tier. It affects your own bill only when your image engine is a Gemini connection that uses your own key. On any other engine the tier does not apply, and the read below shows null for it.

The size a draft starts at

A size you send always wins. A draft that names no size starts at:
  • The Meta image post’s own cut, for the Meta image post: 1080×1350, or another of Meta’s feed ratios when the campaign’s placement calls for it.
  • 1024×1024, when no destination is known, or when the destinations take it as well as any other size does. Every engine makes that size directly, and Gemini makes it at its lower tier.
  • Otherwise, the size that fits the most of the draft’s destinations, the earlier one in the table above on a tie. A campaign whose media buys use a format with a minimum width of 1080 starts at 1080×1080.
The destinations are the ones imageSizes.destinations lists, described below. A starting size above 1024 pixels on its longer side is at Gemini’s 2K tier. A draft saved again before it is generated chooses its starting size again, so it follows the campaign’s media buys as they change.

See which sizes fit your destination

Read an image Creative Session with get:
The session object carries imageSizes. save_creative_session returns the same field whenever it returns the session, including when you save a draft.
The example shows three of the eleven options. Apostra decides which sizes fit from the format’s own declaration: its accepted sizes, minimum and maximum width and height, and accepted aspect ratios. The destinations are:
  • the format the draft names, such as the Meta image post; or
  • for a campaign session that names none, the image formats of the products the campaign’s media buys use, up to 20, always listed in the same order.
When neither applies, or the formats cannot be read, destinations is null. That means Apostra does not know, not that no size fits. The text the tool returns says the same in one line, for example: “Image sizes: 1080×1080 (1:1), 1910×1000 (1.91:1), 1080×1350 (4:5) fit the destination format; the current 1024×1024 does not.”

Choose a size

Send an option’s params as the draft’s request.params when you save the draft:
You can send an aspect ratio instead, as "aspect_ratio": "1:1" in the request, and Apostra uses that ratio’s size from the table. A saved draft keeps its size: to make the image at another size, save a new draft.

In the Creative composer

When the composer’s format is an image, its creative details show an Image size field. It lists the same sizes, marks the ones that fit every destination format, and shows the Gemini tier on a Gemini engine. Below the field, it says which destination formats take the size you picked. Your choice is saved with the draft when you save it, and the concepts the composer generates (today, for a Meta image post: an image plus its copy) are made at that size. A Meta image post starts at 1080×1350; pick 1080×1080 to generate square concepts instead. Changing the format resets the size to the new format’s default. Once concepts have been generated for a draft, its size can no longer change: start a new draft to make concepts at another size.