Bria Product in Hand

Run it

The smallest request that works: the required fields only.

curl https://api.percify.io/v3/playground/v1/run \
  -H "Authorization: Bearer $PERCIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "bria-product-holding",
    "input": {
      "image": "https://example.com/photo.jpg",
      "reference_images": "https://example.com/photo.jpg"
    }
  }'

1. EstimatePOST /estimate with the same body returns the price and charges nothing.
2. RunPOST /run returns an id at once, with status processing.
3. CollectGET /generations/{id}?wait=55 returns the file URLs, or pass a webhook.

Parameters

6 fields in input, required first.

• imageRequired
  string

  The person photo to edit. Public image URL or Base64-encoded image. Supported formats: JPEG, JPG, PNG, and WEBP.

• reference_imagesRequired
  array

  One to three product reference images. Each entry is a public image URL or Base64-encoded image. These are separate from the person photo in image.

• seedOptional
  integer

  Random seed for generation. Omit to use a random seed.

• promptOptional
  string

  Optional instructions to guide the edit. Omit to use the model's built-in instructions.

• aspect_ratioOptional
  1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9

  Optional output aspect ratio. Omit to preserve the person photo's original aspect ratio.

• output_formatOptional
  png, jpegDefault png

  Output image format. Default: png.