# Generate Image - Lite (Coming Soon) Description Generates a new image based on your inputs using the Fibo Lite Pipeline. This all-in-one endpoint utilizes a two-step local-compatible process: 1. FIBO-VLM Bridge: Translates your input (prompt and/or images) into a structured JSON prompt using Bria's open-source VLM. 2. Fibo Lite Model: Internally uses the distilled Fibo Lite text-to-image model to generate the final visual based on that JSON. Fibo Lite's Benefit By pairing the distilled Fibo Lite text-to-image model with the FIBO-VLM bridge, the entire pipeline is capable of fully local, on-prem deployment. To access the local deployment package, please contact us at support@bria.ai. For advanced, programmatic control, you can also pass in your own structured_prompt (e.g., from a previous response or the /v2/structured_prompt/generate/lite endpoint) to bypass the internal VLM bridge. This allows for precise, auditable refinement or recreation of an image, or to generate multiple variations from the same structured prompt. --- Input Combination Rules The request body must include one of the following mutually exclusive combinations: * prompt (Generates a new image from text) * images (Generates a new image inspired by a reference image) * images + prompt (Generates a new image inspired by an image and guided by text) * structured_prompt (Recreates a previous image exactly, combined with a seed) * structured_prompt + prompt (Refines a previous image using new text instructions, combined with a seed) --- API Access You can register and access the API Token through Bria's platform by clicking here. --- Examples Use Case 1: Using a textual prompt * Input Prompt: photorealistic, high resolution rendering, balloon of lettering, "HAPPY NEW YEAR 2026", used color is Pantone Bran, Crocus, Deja vu blue, perfect composition and alignment, natural light set, white backdrop, ultra realistic, rich detail * Output Image: !Example of text-to-image output * Output structured_prompt: json { "short_description": "A photorealistic, high-resolution rendering of balloon lettering spelling out \"HAPPY NEW YEAR 2026\" against a pristine white background. The balloons are meticulously crafted with a metallic, reflective surface, showcasing a vibrant color palette of Pantone Bran, Crocus, and Deja vu blue. The composition is perfectly aligned and balanced, emphasizing the celebratory message with natural, soft lighting that creates subtle, elegant reflections and shadows.", "objects": [ { "description": "A cluster of inflated balloons forming the letters \"HAPPY NEW YEAR 2026\". Each balloon is individually rendered with realistic inflation, knot, and metallic sheen.", "location": "center", "relationship": "The balloons are arranged in two lines: the upper line spelling \"HAPPY NEW YEAR\" and the lower line spelling \"2026\".", "relative_size": "large within frame", "shape_and_color": "Spherical and teardrop shapes, in metallic shades of Pantone Bran (yellow-orange), Crocus (pink), and Deja vu blue (deep blue).", "texture": "smooth, glossy, metallic, reflective", "appearance_details": "Each balloon has a visible knot at the bottom, and their surfaces reflect light with a subtle, iridescent quality, mimicking real foil balloons.", "number_of_objects": 20, "orientation": "upright" } ], "background_setting": "A clean, bright, and uniform white background, providing stark contrast to the colorful balloons and ensuring maximum readability and visual impact.", "lighting": { "conditions": "bright, even studio lighting", "direction": "soft, diffused lighting from multiple sources", "shadows": "subtle, soft, and elongated shadows cast by the balloons onto the white background, indicating a light source from above and slightly to the front, adding depth without distraction." }, "aesthetics": { "composition": "centered, symmetrical, and balanced composition, with the text arranged in two horizontal lines", "color_scheme": "A harmonious blend of warm (Pantone Bran, Crocus) and cool (Deja vu blue) metallic colors against a neutral white, creating a festive yet sophisticated palette.", "mood_atmosphere": "festive, celebratory, elegant, joyful, optimistic", "preference_score": "very high", "aesthetic_score": "very high" }, "photographic_characteristics": { "depth_of_field": "deep", "focus": "sharp focus on all balloons and text", "camera_angle": "eye-level", "lens_focal_length": "standard lens (e.g., 50mm)" }, "style_medium": "3D render", "text_render": [ { "text": "HAPPY NEW YEAR", "location": "top-center", "size": "large", "color": "metallic (Pantone Bran, Crocus, Deja vu blue)", "font": "rounded, sans-serif balloon letters", "appearance_details": "Each letter is formed by multiple inflated balloons, with the colors cycling through the palette." }, { "text": "2026", "location": "bottom-center", "size": "large", "color": "metallic (Pantone Bran, Crocus, Deja vu blue)", "font": "rounded, sans-serif balloon numbers", "appearance_details": "Each number is formed by multiple inflated balloons, with the colors cycling through the palette." } ], "context": "This is a graphic design asset or a celebratory greeting card, likely intended for New Year's Eve promotions, digital greetings, or print media for the year 2026.", "artistic_style": "photorealistic, festive, clean" } --- Use Case 2: Drawing inspiration from a reference image * Input Image: !Example of reference image input * Input Prompt: generate a couple in this style * Output Image: !Example of image-to-image output * Output structured_prompt: json { "short_description": "A vibrant and dynamic painting in the style of Vincent van Gogh, depicting a couple standing in a landscape under a swirling, star-filled night sky. The scene features rolling hills, a small village with a church steeple, and cypress trees, all rendered with thick impasto brushstrokes and a rich, saturated color palette dominated by blues and yellows.", "objects": [ { "description": "A man with short, dark hair and a light-colored shirt, standing with his left arm around a woman.", "location": "center-left foreground", "relationship": "The man is embracing the woman, standing together in the landscape.", "relative_size": "large within frame", "shape_and_color": "Human figures, with earthy tones for clothing and skin.", "texture": "Thick, impasto brushstrokes, giving a textured, painterly feel.", "appearance_details": "Their faces are turned slightly towards each other, with soft, warm expressions.", "pose": "Standing upright, with the man's left arm around the woman's waist.", "expression": "Calm and affectionate.", "clothing": "The man wears a light-colored, possibly blue or white, shirt. The woman wears a dark dress.", "action": "Embracing.", "gender": "male", "skin_tone_and_texture": "Fair skin tones, rendered with visible brushstrokes.", "orientation": "vertical" }, { "description": "A woman with long, dark hair and a dark dress, standing next to a man.", "location": "center-left foreground", "relationship": "The woman is embraced by the man, standing together in the landscape.", "relative_size": "large within frame", "shape_and_color": "Human figures, with earthy tones for clothing and skin.", "texture": "Thick, impasto brushstrokes, giving a textured, painterly feel.", "appearance_details": "Her face is turned slightly towards the man, with soft, warm expressions.", "pose": "Standing upright, with her right arm gently resting on the man's arm.", "expression": "Calm and affectionate.", "clothing": "The woman wears a dark, possibly blue or green, dress.", "action": "Embracing.", "gender": "female", "skin_tone_and_texture": "Fair skin tones, rendered with visible brushstrokes.", "orientation": "vertical" }, { "description": "A tall, slender cypress tree with dark green foliage.", "location": "mid-left foreground", "relationship": "It stands prominently in the foreground, partially obscuring the village and providing a vertical element against the swirling sky.", "relative_size": "large within frame", "shape_and_color": "Conical shape, dark green with hints of brown and black.", "texture": "Rough, textured surface created by thick paint application.", "appearance_details": "The brushstrokes are visible, giving it a sense of movement and depth.", "orientation": "vertical" }, { "description": "A small village with several houses and a prominent church steeple.", "location": "mid-ground, spanning from left to right", "relationship": "The village is nestled in the valley below the hills and beneath the starry sky, providing a sense of scale and human presence.", "relative_size": "medium", "shape_and_color": "Various rectangular and triangular shapes for houses, with a tall, slender steeple. Colors are predominantly blues, browns, and whites.", "texture": "Painterly texture with visible brushstrokes, suggesting architectural forms.", "appearance_details": "Some windows of the houses appear lit, adding warmth to the scene. The church steeple is light-colored and stands out against the darker hills.", "number_of_objects": 1, "orientation": "horizontal" }, { "description": "A bright yellow full moon, surrounded by a soft glow.", "location": "top-right", "relationship": "The moon is a central celestial body in the dramatic sky, illuminating the scene.", "relative_size": "large", "shape_and_color": "Circular, bright yellow with lighter highlights.", "texture": "Smooth yet painterly, with visible brushstrokes creating a luminous effect.", "appearance_details": "It has a distinct halo effect, radiating light.", "orientation": "vertical" } ], "background_setting": "A vast, swirling night sky filled with numerous bright yellow stars and dynamic blue and white clouds. The sky transitions from deep indigo at the top to lighter blues and greens closer to the horizon. Below the sky, there are undulating hills and fields, rendered in various shades of blue, purple, and green, suggesting a rural landscape.", "lighting": { "conditions": "moonlight and starlight", "direction": "diffuse from above and right (from the moon)", "shadows": "soft, implied shadows on the hills and trees, contributing to depth but not sharply defined." }, "aesthetics": { "composition": "dynamic and asymmetrical, with the couple and cypress trees anchoring the left side, balanced by the moon and village on the right. The swirling sky creates a sense of movement and draws the eye across the canvas.", "color_scheme": "predominantly cool blues and greens, contrasted with warm yellows of the stars and moon, creating a high-contrast and energetic palette.", "mood_atmosphere": "dreamlike, romantic, serene yet dramatic, with a sense of wonder and cosmic connection.", "preference_score": "very high", "aesthetic_score": "very high" }, "photographic_characteristics": { "depth_of_field": "deep", "focus": "all elements are in focus, characteristic of a painting, with emphasis on the brushwork.", "camera_angle": "eye-level, as if observing the landscape and sky from a standing position.", "lens_focal_length": "standard lens (e.g., 35mm-50mm)" }, "style_medium": "oil painting", "context": "An artistic interpretation of a romantic landscape, evoking the style and emotional intensity of Van Gogh's post-impressionist works. It could be used as a fine art piece, a book cover, or a romantic illustration.", "artistic_style": "Post-Impressionist, Van Gogh-esque, expressive." } --- Use Case 3: Refining a previously generated image * Input Image (from previous response - shouldn't be part of the refine request): !Example of input image * Input structured_prompt (from previous response - should be part of the refine request, toegther with the seed of the visual result): json { "short_description": "A hyper-detailed, ultra-fluffy owl sitting in the trees at night, looking directly at the camera with wide, adorable, expressive eyes. Its feathers are soft and voluminous, catching the cool moonlight with subtle silver highlights. The owl's gaze is curious and full of charm, giving it a whimsical, storybook-like personality.", "objects": [ { "description": "An adorable, fluffy owl with large, expressive eyes and soft, voluminous feathers. It has a round head, small ear tufts, and a slightly downturned beak. Its plumage is a mix of warm browns, grays, and subtle silver highlights from the moonlight.", "location": "center", "relationship": "The owl is the sole subject, perched comfortably within its environment.", "relative_size": "large within frame", "shape_and_color": "Round head, oval body, predominantly brown and grey with silver highlights.", "texture": "Extremely soft, fluffy, and detailed feathers, giving a plush toy-like appearance.", "appearance_details": "The eyes are wide, dark, and reflective, conveying a sense of wonder and innocence. The beak is small and light-colored, almost blending with the feathers.", "number_of_objects": 1, "pose": "Sitting upright, body facing slightly to the right, head turned to face forward.", "expression": "Curious, innocent, and charming.", "action": "Sitting and observing.", "gender": "unknown", "orientation": "upright" } ], "background_setting": "A dark, blurred forest at night, with hints of tree trunks and foliage visible. The background is uniformly dark, emphasizing the owl as the central focus. Moonlight subtly illuminates parts of the background, creating a soft, ethereal glow.", "lighting": { "conditions": "moonlight", "direction": "top-left, casting subtle highlights", "shadows": "soft, diffused shadows on the right side of the owl and within the background foliage, indicating a gentle light source." }, "aesthetics": { "composition": "centered, portrait composition, with the owl filling a significant portion of the frame.", "color_scheme": "cool blues and silvers from the moonlight contrasting with warm browns and grays of the owl's feathers, creating a balanced and enchanting palette.", "mood_atmosphere": "magical, serene, whimsical, and endearing.", "preference_score": "very high", "aesthetic_score": "very high" }, "photographic_characteristics": { "depth_of_field": "shallow", "focus": "sharp focus on the owl's face and eyes, with a soft blur in the background.", "camera_angle": "eye-level, as if observing the owl directly.", "lens_focal_length": "portrait lens (e.g., 50mm-85mm)" }, "style_medium": "digital illustration", "context": "A whimsical character illustration, likely intended for children's books, animated media, or as a charming decorative art piece.", "artistic_style": "fantasy, cute, detailed" } * Input Refinement Prompt: turn the scene into a daylight scene, with sunlight * Output Image: !Example of refinement output * Output structured_prompt (refined): json { "short_description": "A hyper-detailed, ultra-fluffy owl sitting in the trees during the day, looking directly at the camera with wide, adorable, expressive eyes. Its feathers are soft and voluminous, catching the warm sunlight with subtle golden highlights. The owl's gaze is curious and full of charm, giving it a whimsical, storybook-like personality.", "objects": [ { "description": "An adorable, fluffy owl with large, expressive eyes and soft, voluminous feathers. It has a round head, small ear tufts, and a slightly downturned beak. Its plumage is a mix of warm browns, grays, and subtle golden highlights from the sunlight.", "location": "center", "relationship": "The owl is the sole subject, perched comfortably within its environment.", "relative_size": "large within frame", "shape_and_color": "Round head, oval body, predominantly brown and grey with golden highlights.", "texture": "Extremely soft, fluffy, and detailed feathers, giving a plush toy-like appearance.", "appearance_details": "The eyes are wide, dark, and reflective, conveying a sense of wonder and innocence. The beak is small and light-colored, almost blending with the feathers.", "number_of_objects": 1, "pose": "Sitting upright, body facing slightly to the right, head turned to face forward.", "expression": "Curious, innocent, and charming.", "action": "Sitting and observing.", "gender": "unknown", "orientation": "upright" } ], "background_setting": "A dark, blurred forest during the day, with hints of tree trunks and foliage visible. The background is uniformly dark, emphasizing the owl as the central focus. Sunlight subtly illuminates parts of the background, creating a soft, ethereal glow.", "lighting": { "conditions": "sunlight", "direction": "top-left, casting subtle highlights", "shadows": "soft, diffused shadows on the right side of the owl and within the background foliage, indicating a gentle light source." }, "aesthetics": { "composition": "centered, portrait composition, with the owl filling a significant portion of the frame.", "color_scheme": "warm yellows and oranges from the sunlight contrasting with warm browns and grays of the owl's feathers, creating a balanced and enchanting palette.", "mood_atmosphere": "magical, serene, whimsical, and endearing.", "preference_score": "very high", "aesthetic_score": "very high" }, "photographic_characteristics": { "depth_of_field": "shallow", "focus": "sharp focus on the owl's face and eyes, with a soft blur in the background.", "camera_angle": "eye-level, as if observing the owl directly.", "lens_focal_length": "portrait lens (e.g., 50mm-85mm)" }, "style_medium": "digital illustration", "context": "A whimsical character illustration, likely intended for children's books, animated media, or as a charming decorative art piece.", "artistic_style": "fantasy, cute, detailed" } Endpoint: POST /image/generate/lite ## Header parameters: - `api_token` (string, required) ## Request fields (application/json): - `prompt` (string) Text-based instruction. Can be used alone to create a new prompt, or as a refinement command with an images or structured_prompt. - `images` (array) Publicly available URL or Base64-encoded image. Currently supports a single image. Supported formats: JPEG, JPG, PNG, WEBP. - `structured_prompt` (string) A string containing the structured prompt in JSON format. Use a structured_prompt from a previous generation's response or the /v2/structured_prompt/generate/lite endpoint for precise refinement. - `guidance_scale` (integer) Determines how closely the generated image should adhere to the content in the prompt parameter. This parameter is optional. - `model_version` (string) Generation model version. This parameter is optional. * If omitted (Default): Your request will automatically use Bria's current default model. This ensures you always benefit from our latest improvements. * If specified (e.g., "FIBO"): Your request will be pinned to this exact version. Enum: "FIBO" - `aspect_ratio` (string) Image aspect ratio. This parameter is optional. Enum: "1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9" - `steps_num` (integer) Number of diffusion steps. Uses model default if omitted. This parameter is optional. - `seed` (integer) Seed for deterministic generation. Uses a random seed if omitted. This parameter is optional. - `sync` (boolean) Response mode. This parameter is optional. * false (default): Asynchronous. Returns 202 with a status_url to poll. * true: Synchronous. Holds the connection and returns 200 with the final result. - `ip_signal` (boolean) If true, returns a warning for potential IP content in the prompt parameter. This parameter is optional. - `prompt_content_moderation` (boolean) If true, returns 422 on input prompt moderation failure in the prompt parameter. This parameter is optional. - `visual_input_content_moderation` (boolean) If true, returns 422 on visual input moderation failure. This parameter is optional. - `visual_output_content_moderation` (boolean) If true, returns 422 on visual output moderation failure. This parameter is optional. ## Response 200 fields (application/json): - `result` (object, required) - `result.image_url` (string, required) - `result.seed` (integer, required) - `result.structured_prompt` (string, required) - `request_id` (string, required) - `warning` (string) Returned only when ip_signal = true and the prompt field included IP content. ## Response 202 fields (application/json): - `request_id` (string, required) - `status_url` (string, required) - `warning` (string) Returned only when ip_signal = true and the prompt field included IP content. ## Response 400 fields (application/json): - `error` (object, required) - `error.code` (integer, required) Example: 123 - `error.message` (string, required) - `error.details` (string) - `request_id` (string, required) ## Response 401 fields (application/json): - `error` (object, required) - `error.code` (integer, required) Example: 123 - `error.message` (string, required) - `error.details` (string) - `request_id` (string, required) ## Response 403 fields (application/json): - `error` (object, required) - `error.code` (integer, required) Example: 123 - `error.message` (string, required) - `error.details` (string) - `request_id` (string, required) ## Response 422 fields (application/json): - `error` (object, required) - `error.code` (integer, required) Example: 123 - `error.message` (string, required) - `error.details` (string) - `request_id` (string, required) ## Response 429 fields (application/json): - `error` (object, required) - `error.code` (integer, required) Example: 123 - `error.message` (string, required) - `error.details` (string) - `request_id` (string, required) ## Response 5XX fields (application/json): - `error` (object, required) - `error.code` (integer, required) Example: 123 - `error.message` (string, required) - `error.details` (string) - `request_id` (string, required)