# Reimagine - Portrait Reference

This endpoint lets you change the style of a portrait while keeping the person’s id. 
It works by using a reference image of the person along with a trained tailored model.

This capability is specifically designed for portraits that capture the subject from the torso up, with a recommended face size of at least 500×500 pixels. Images that do not meet these guidelines may produce inconsistent results.

Model Compatibility Note:
This feature supports only tailored models trained using the Light training version, tailored models trained in Expert training mode based on Bria 2.3, or uploaded tailored models that were trained based on Bria 2.3.


Endpoint: POST /tailored-gen/restyle_portrait

## Header parameters:

  - `api_token` (string, required)

## Request fields (application/json):

  - `id_image_url` (string)
    A publicly available URL of the ID reference image. If both  and  are provided,   
  will be used. Supported formats: , , , .

  - `id_image_file` (string)
    The image file containing the ID reference, in base64 format. This parameter is used if  is not provided. 
Accepted formats: , , , .

  - `tailored_model_id` (string)
    The model id of the tailored model you would like to use in the request.

  - `tailored_model_influence` (number)
    The influence of the tailored model on the generation. When the training data was minimal or less diverse, lower the influence to improve flexibility in the results.

  - `steps_num` (integer)
    The number of iterations the model goes through to refine the generated image. This parameter is optional.

  - `enhance_image` (boolean)
    When set to true, generates images with richer details, sharper textures, and enhanced clarity.

Slightly increases generation time per image.

  - `content_moderation` (boolean)
    When enabled, applies content moderation to both input visuals and generated outputs.

For input images:
- Processing stops at the first image that fails moderation
- Returns a 422 error with details about which parameter failed

For synchronous requests (sync=true):
- If all generated images fail moderation, returns a 422 error
- If some images pass and others fail, returns a 200 response with successful generations and "blocked" objects for failed ones

For asynchronous requests (sync=false):
- Failed images are replaced with zero-byte files at their placeholder URLs
- Successful images are stored at their original placeholder URLs

  - `id_strength` (number)
    The influence of the ID reference image on the generated image.

  - `sync` (boolean)
    Determines the response mode. When true, responses are synchronous. With false, responses are asynchronous, immediately providing URLs for images that are generated in the background. Use polling for the URLs to retrieve images once ready.

## Response 200 fields (application/json):

  - `result` (array)
    List of generated images or blocked results.

  - `result.image_url` (string)
    URL where the generated image is stored.