Tutorial
imagen-4.0-ultra in Practice: 5 High-Value Image Generation Scenarios and Key Deployment Points
A practical integration checklist for engineering teams, from scenario selection and prompt structure to per-image cost accounting
Why let the scenario decide whether to integrate an image model
The most common mistake when making integration decisions for image generation models is starting from "model capabilities" rather than from "business scenarios." It is easy to green-light a project after seeing one stunning demo image, only to get stuck after the PoC is complete on the same question: exactly whose work hours does this image eliminate, or what measurable benefit does it bring?
During the model selection phase, we recommend first making a simple branching judgment:
- Is the need a form of "repetitive visual output"? For example, batch variants of the same layout across different products and different copy. This is the most solid fit for image models.
- Does the need allow "approximately correct"? Image generation is probabilistic output, and multiple calls with the same prompt do not produce consistent results. For scenarios with strict pixel-level consistency or strong brand guideline constraints, additional review and post-processing steps are required.
- Is there a clear acceptance owner for the need? If no one is willing to sign off on the result, the acceptance criteria for this scenario have not been defined clearly; do not launch it yet.
- Can the value of replacing manual work be estimated? Use "the time a single image previously took an outsourced vendor or designer × hourly rate" to get a rough labor cost, then compare it with the model call cost.
Typical cases that are not suitable for integration should also be stated up front: finished materials that require precise typography, scenarios that require strictly reproducing the same reference image, and externally published scenarios where the compliance review process has not yet been established. These are not model capability issues but process issues; integration will only move the risk earlier.
Writing the points above into a one-page decision checklist will help the team make the decision far better than any benchmark number.

Capability boundaries and billing basis of imagen-4.0-ultra
The output type of imagen-4.0-ultra is images, and its core task is text-to-image: input a text prompt and return a generated image. This means it is not responsible for tasks such as image editing, inpainting, or image-to-image. If your scenario requires "changing one place on an existing image," first confirm whether a corresponding task type exists instead of forcing text-to-image to approximate it.
Three points about capability boundaries should be written into the documentation during the design phase:
- The output is the image itself, not structured data. If metadata such as dimensions or subject position is needed later, record the prompt and parameters on the calling side instead of expecting the model to return them.
- Results are probabilistic. Multiple calls with the same prompt will not be completely consistent. Reproducibility must be obtained indirectly by fixing parameters and saving call records.
- The prompt is the only primary control mechanism. The quality of the prompt structure directly determines the usability rate, and this point is expanded in each scenario below.
The billing basis is priced per generated image: each successful output is billed once. This basis is friendly to cost estimation: the cost of a batch task is roughly equal to "expected number of output images ÷ usability rate × per-image cost," where the usability rate must be measured by you on real business prompts. For the specific unit price, refer to the pricing panel on the site and do not use numbers from third-party channels for budgeting.
For the calling path, always send requests through the HiAPI.ai interface and do not rely on any direct upstream connection. In this way, business code will not need to change when switching to or combining other image models later.

Scenario 1: Batch variant generation for marketing materials
Marketing materials are one of the scenarios with the highest return on investment for image models: the same campaign information needs multiple size sets such as landscape, portrait, and square, and also needs several visual style versions for placement testing. The manual approach is for a designer to create one key visual and then derive variants; the model approach is to split the "key visual description" into variable prompt slots.
The recommended prompt structure is "fixed segment + variable segment": the fixed segment describes brand tone, composition rules, aspect ratio, and prohibited elements; the variable segment only replaces the subject, scene atmosphere, and color tendencies. In this way, during batch generation, style drift mainly comes from the variable segment, and the burden of manual selection remains manageable.
Key implementation points:
- Maintain a mapping between each variant and its
variant_id, prompt, and parameters, and save them together when persisting results, making reproduction and retrospective analysis easier. - Run batch tasks in two stages, "small sample first, then scale up": first generate a small number of candidates for each variant, manually pick the viable directions, then scale up the winning directions.
- The manual selection step must be part of the process; do not try to fully replace it with automated scoring. A feasible compromise is to have reviewers make only a binary "keep/discard" decision, reducing the cost of reviewing each image.
The benefit measurement for this scenario is straightforward: compare the cycle from requirement to delivery for a set of materials under the previous process, and the number of material variants that can be obtained in each round of placement testing.
Scenario 2: Product images and e-commerce listing page visuals
E-commerce scenarios impose stricter constraints on images than marketing materials, because listing pages have unified display standards: white or fixed background, centered subject, consistent margin ratio, and no elements that conflict with watermarks or promotional copy. These constraints should be pushed into the prompt as much as possible rather than left to post-processing.
We recommend organizing prompts into three layers:
Standards layer
Hard-code the aspect ratio, background treatment, subject proportion, lighting direction, and prohibited elements (text, logos, unnecessary props). This layer is common to all products and should be maintained as template constants.
Category layer
Maintain a short description template per category. For example, apparel emphasizes material and drape, home goods emphasize scene atmosphere, and digital products emphasize clean product texture. Category templates should be maintained jointly by operations and design, avoiding ad hoc writing by engineering.
Individual product layer
Fill in only the objective attributes of the product itself: color, material, shape, and key components. The content of this layer should come from structured product data rather than free-form manual writing, so that prompts can be assembled automatically.
Two things need attention during deployment: first, generated results must pass dimension and margin checks, and those that fail go directly into the retry queue; second, keep a set of manually photographed or retouched baseline images for regularly evaluating changes in the usability rate of generated images, because prompts and category structures will continue to evolve.
Scenario 3: In-app illustrations and empty state images
The characteristics of illustration needs within products are: the value of a single image is not high, but the volume is large and iteration is frequent, and the communication cost of outsourcing often exceeds the drawing itself. Empty states, onboarding pages, and feature explanation illustrations all fall into this category.
The key to replacing them with image models is not the quality of a single image but style consistency. The approach is to solidify the style description into a reusable style prefix, such as line thickness, coloring method, and principles for handling perspective and character proportions, and concatenate the same prefix to all illustration requests. At the same time, maintain a collection of adopted illustrations as a manual reference for style drift.
A few engineering implementation suggestions:
- Abstract illustration requests into three fields: "scene + subject + emotion," and let the service layer assemble them into a complete prompt, so product colleagues only need to fill in the fields.
- Archive generated results by the
scenedimension, keeping multiple generations for the same scene together for side-by-side selection. - Conduct regular spot checks on style consistency; when drift is found, prioritize fixing the style prefix rather than reworking image by image.
For this scenario, we recommend setting acceptance criteria pragmatically: do not pursue commercial illustration quality for every image, but look at the "directly usable ratio" and "time from request to obtaining a usable image." Most teams will clearly outperform the outsourcing process on these two metrics.
Scenario 4: Content illustrations and automatic cover generation
The typical form of integrating image models into a content system is: automatically generate a cover image when an article or page is published. The core difficulty here is not generation but automatic conversion from body text to prompt and failure fallback.
We recommend designing the prompt generation pipeline as follows: first have a text model extract four elements from the title and body summary—subject, scene, atmosphere, and emotion—then insert them into a fixed cover style template (aspect ratio, composition margins, position of the visual focal point) to assemble the final prompt. Do not let the text model freely write the prompt directly; otherwise the style will drift significantly with the article topic.
A fallback strategy is mandatory, arranged by priority:
- Adopt the generated result if it passes basic checks (dimensions, obvious absence of the subject);
- If it fails the first time, retry once with the same prompt; if it still fails, fall back to a generic style template and generate once more;
- If everything fails, use a preset default cover image to ensure the publishing process is not blocked.
Another thing to handle is idempotency: repeatedly triggering publication of the same article should not generate and bill again. Use content ID plus version number as the deduplication key, and directly reuse already generated results.
Scenario 5: Concept sketches in early-stage design and creative work
The most reasonable place for design teams to use image models is the early creative stage, not the delivery stage. It replaces the step of "drawing several rough drafts to align on direction," not the final output.
A practical collaboration process is: design or product first describes the direction in natural language and generates a batch of concept sketches, which are used in review meetings to quickly converge on "what we want and what we do not want"; after the direction is determined, designers then refine details and standardize based on the selected sketches. In this way, the model output always serves as discussion material and does not enter deliverables, avoiding quality disputes.
Several practical points:
- In the sketch stage, prompts may be casual, but exploration records should be kept so it is easy to trace how a direction emerged.
- Make team agreements explicit: generated images are not published externally and are not used as the basis for design standards.
- Distill the feedback phrases that most often appear in reviews (too cluttered, too empty, color tone too cool, etc.) into prompt correction phrases to improve the hit rate in the next round.
The cost of this scenario is extremely low, and its value lies in shortening the communication rounds for direction alignment. It can be measured by "the number of directions converged in one review meeting" or "the number of days from project initiation to determining the key visual."

Encapsulate generation capabilities into a service layer and a cost control checklist
Whichever scenario is implemented first, we recommend adding an internal image service layer between business code and the model interface to centralize prompt assembly, calls, validation, archiving, and retries. The direct benefit is that when switching models later or combining different models by scenario, only the service layer configuration needs to change, with zero changes on the business side.
We recommend the following responsibility boundaries for the service layer:
- Prompt construction: accept structured input parameters and output complete prompts; templates are centrally managed and versionable.
- Calls and concurrency control: uniformly go through the HiAPI.ai interface, set concurrency limits and queuing, and avoid burst traffic overwhelming the quota.
- Result validation: check dimensions, margins, and basic quality; failures enter retry.
- Archiving and deduplication: persist by business key and record prompts, parameters, and results to support reproduction and idempotency.
The focus of cost control is the retry strategy and batch scheduling, not squeezing the unit price: pricing per image means that failed retries and blind scale-ups without human review are the main sources of cost leakage. A few actionable principles:
- Set a hard retry cap, for example retry at most once, to avoid infinitely multiplying costs from abnormal prompts.
- For batch tasks, start with small samples before scaling up, and estimate the total from measured usability rates rather than ordering based on the theoretical maximum.
- Set budget caps for low-value scenarios, count generation volume and adoption volume separately by business line, and regularly clean up scenarios with zero adoption over the long term.
- Save the prompt and result of every call so that cost reviews can pinpoint the specific scenario and template.
Writing these points into the launch checklist is more effective than post-hoc optimization. For specific unit prices and quotas, refer to the pricing panel on the site. Get one scenario working end to end first, then expand gradually; this is more stable than rolling out everything at once.
Related articles
View all articles →-
Tutorial
How to Call hailuo-2.3-fast/image-to-video via the HiAPI API: curl and Python
A first working request for the fast, low-cost image-to-video tier — from model ID to downloaded MP4
9 min read -
Tutorial
How to Use hailuo-2.3/text-to-video via the HiAPI API: curl, Python, and a Working Request
11 min read -
Tutorial
Kandinsky 6.0 Pro Text-to-Video on HiAPI: curl and Python Tutorial
A request-first walkthrough: build the prompt-to-clip call, submit it, poll for completion, and download the result
11 min read