---
title: "Generate Structured Prompt - Lite"
method: POST
path: "/structured_prompt/generate/lite"
tags: ["Endpoints"]
---

# Generate Structured Prompt - Lite

`POST /structured_prompt/generate/lite`

Creates a new detailed, machine-readable structured prompt in JSON format for the **speed-optimized Fibo Lite Pipeline**.

This endpoint uses Bria's standard **FIBO-VLM** bridge (open-source, available on Hugging Face) to generate the prompt. 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/lite`.
* **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/lite` multiple times to create consistent, auditable variations.
* **Local Deployment Support:** This bridge is designed to pair seamlessly with the Fibo Lite text-to-image model. This combination enables **fully local, on-prem deployment** and unlocks Fibo Lite's **faster inference speeds**. Contact <a href="mailto:support@bria.ai">support@bria.ai</a> for more information.

The resulting `structured_prompt` can be used as input for the `/v2/image/generate/lite` 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>.

## Headers

- `api_token` string, required

## Request body

- object
  - `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` string[] — 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.
  - `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.
  - `webhook_url` string, uri — Optional URL for receiving the result via webhook when the async job completes. See [Webhooks](https://docs.bria.ai/webhooks).
  - `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.

## Response `200`

Successful operation (Synchronous Success)

- SyncSuccessStructPromptGenerate
  - `result` object, required
    - `seed` integer, required
    - `structured_prompt` string, required
  - `request_id` string, required
  - `warning` string — Returned only when ip_signal = true and the prompt field included IP content.

## Other responses

- `202` — Accepted (Asynchronous). You can track the progress and retrieve the final result using the Status Service. For more details, refer to the [Status Service](https://docs.bria.ai/status) section.
- `400` — Bad request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `422` — Unprocessable Entity (e.g., moderation failure)
- `429` — Request limit exceeded.
- `5XX` — Internal Server Error

---

[API](https://skmtc.net/bria-ai/apis/image-generation-api-reference.md) · [All operations](https://skmtc.net/bria-ai/apis/image-generation-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bria-ai/image-generation-api-reference/versions/5f2b82f9c3b4/schema)