Hey team, posting this in API discussion because it's a developer workflow issue.
When using POST /v1.0/generations, the first card often returns image-layout="behind" and an empty accent image slot, regardless of what's in the request. Every subsequent card correctly returns image-layout="blank". The empty slot renders as a gray band above the content on the first card, which is visible to end users of documents we generate programmatically.
Our setup: format: document, textMode: preserve, cardSplit: inputTextBreaks, cardOptions.dimensions: pageless, imageOptions.source: noImages. We are not using GML. We are on the plain text and additionalInstructions path.
We have tried explicit additionalInstructions wording telling the generator not to use a cover layout on the first card. Results are inconsistent.
What we are asking for is a request parameter such as firstCardLayout: "blank" or suppressCoverLayout: true that tells the generator to treat the first card identically to all other cards, with no accent image slot. Alternatively, honoring imageOptions.source: noImages consistently on the first card the same way it does on all subsequent cards would solve it.
This comes up across virtually every document we generate and currently requires a post-generation patch call to fix. A single parameter would eliminate that entirely.