---
title: "Generate Visual Schema"
method: POST
path: "/tailored-gen/generate_visual_schema"
tags: ["Dataset"]
---

# Generate Visual Schema

`POST /tailored-gen/generate_visual_schema`

Generates a structured JSON visual schema (backbone) based on the provided sample images.

The visual schema represents mutual characteristics (style, IP, colors, etc.) across training images and is used for:
1. Caption generation during image upload.
2. Prompt translation (user text → structured prompt) during generation.

**Usage:**
- Provide 5-10 representative images of your style/IP.
- The returned `visual_schema` string must be added to your dataset using `PUT /tailored-gen/datasets/{dataset_id}`.

This endpoint supports content moderation via an optional parameter.

## Headers

- `api_token` string, required

## Request body

- object
  - `images` string[], required — An array of 5-10 images. Supports base64-encoded strings or public URLs. Supported formats are png, jpg, jpeg, webp.
  - `content_moderation` boolean

## Response `200`

Successfully generated visual schema.

- object
  - `visual_schema` string — A string containing the structured JSON visual schema.

## Other responses

- `400` — Bad request (invalid number of images).
- `401` — Unauthorized.
- `403` — Forbidden.
- `415` — Unsupported Media Type.
- `422` — Unprocessable Entity (moderation failure).
- `429` — Request limit exceeded.
- `500` — Internal server error.

---

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