Product image APIs should optimize for accepted listing assets — not raw generations that never survive merchandising review.
“Three sculptural cosmetic containers on a coral studio set, soft shadows, tactile materials, premium beauty campaign, portrait layout”
FLUX Schnell · fast · 960 × 1472Start with creative layers that do not rewrite the product
The lowest-risk ecommerce use cases generate context around an existing product: a background concept, seasonal scene, color direction, or campaign mood board. Fully synthetic product depictions can invent labels, ports, materials, proportions, and included accessories, creating returns or compliance risk.
Separate factual product attributes from creative direction. Facts come from the catalog and are locked. Art direction comes from an approved template. The model should never be the authority for claims such as capacity, ingredients, certifications, compatibility, or package contents.
- Background and surface ideation
- Campaign composition drafts
- Lifestyle scene concepts with later compositing
- Variant mood boards
- Internal merchandising previews
Use versioned prompt templates for repeatable catalog output
A template can define camera position, lens feel, lighting, negative space, surface, palette, and prohibited elements. Product-specific values fill controlled slots. Version the template so a rerender months later can be traced to the creative rules that produced it.
RenderRoute does not silently rewrite prompts. That is useful for auditability: your application owns the template and the final text sent to the model. Store the provider and model returned in response metadata alongside the asset record.
SUBJECT: {{trusted_product_description}}
SCENE: {{approved_campaign_scene}}
COMPOSITION: centered three-quarter view, 20% clear space above
LIGHT: large softbox from camera left, subtle rim light
MUST NOT INCLUDE: extra accessories, altered logo, invented textGenerate for the destination aspect ratio from the beginning
Cropping a square concept into a vertical marketplace card can remove the product or the intended negative space. Define named presets for each channel and send those dimensions to the model. RenderRoute keeps every side on a 64-pixel grid for broad provider compatibility.
Use 1024×1024 for square discovery, 960×1472 for portrait cards, and 1472×960 for landscape concepts as starting points. Validate each marketplace’s current technical and content requirements before publishing; channel rules change independently of your generation stack.
| Preset | Dimensions | Typical use |
|---|---|---|
| Square | 1024 × 1024 | Catalog and social tiles |
| Portrait | 960 × 1472 | Mobile cards and editorial |
| Landscape | 1472 × 960 | Banners and campaign concepts |
Build a rejection checklist before automating publication
Human review should check product identity, geometry, label and text accuracy, color, included items, prohibited claims, anatomy in lifestyle scenes, artifacts, and channel policy. High-volume teams can add computer vision checks, but automated approval should be earned through measured precision on the exact catalog domain.
Track rejection reasons. If one template produces frequent label corruption, route it to compositing or a different model rather than increasing prompt complexity indefinitely. The best API design makes failed creative cheap to diagnose and easy to replace.
Questions about product image generation API
Can the API preserve an exact product photo?
The current API is text-to-image. Exact preservation usually needs image-to-image, masking, compositing, or a product-specific workflow that should be added as a separate reviewed endpoint.
Can generated images go live automatically?
Not at launch. Use human approval until your domain-specific QA system has demonstrated reliable performance.
What portrait size is supported?
960×1472 is the included preset and both values are multiples of 64.
How do I stop invented product text?
Use negative instructions, avoid asking the model to reproduce critical labels, and composite verified packaging or typography after generation.