Generate Structured Prompt

Creates a new detailed, machine-readable structured prompt in JSON format or refines an existing one using text or image inputs.

This endpoint uses the state-of-the-art Gemini 2.5 Flash VLM bridge to generate the prompt, providing superior understanding of nuanced or complex inputs. It only returns the JSON string and does not generate an image.

Why use this endpoint?

This endpoint decouples the "intent translation" step from the "image generation" step, giving you maximum flexibility.

• It's Optional: The same structured prompt generation happens automatically behind the scenes when using /v2/image/generate.
• Control & Auditability: Allows for a "human-in-the-loop" to inspect, programmatically edit, or version the JSON before generating an image (e.g., for a custom UI).
• Consistency & Automation: Generate one structured_prompt and pass it to /v2/image/generate multiple times to create consistent, auditable variations.
• Hybrid Deployment: Use Bria's state-of-the-art VLM bridge via API while self-hosting the open-source FIBO image model on your own private cloud.

The resulting structured_prompt can be used as input for the /v2/image/generate endpoint.

Input Combination Rules

The request body must use exactly one of the following combinations:

• Text Only: prompt
• Image Only: images
• Image and Text: images and prompt
• Structured Prompt and Text: structured_prompt and prompt

---

** API Access **

You can register and access the API Token through Bria's platform <a href="https://platform.bria.ai/console/account/api-keys" target="_blank">by clicking here</a>.