BrightShotBrightShot API
Image Generation

Modify with mask

Make specific modifications to parts of an image using a mask.

POST
/api/v1/modify
AuthorizationBearer <token>

API key in format: bs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

In: header

image_urlstring

URL of the original image

Formaturi
mask_urlstring

URL of the mask image (white areas will be modified)

Formaturi
promptstring

Description of what to generate in the masked area

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.bright-shot.com/api/v1/modify" \  -H "Content-Type: application/json" \  -d '{    "image_url": "https://example.com/room.jpg",    "mask_url": "https://example.com/mask.png",    "prompt": "A modern leather armchair"  }'
{
  "success": true,
  "request_id": "pred_abc123xyz",
  "message": "Generation started. Poll /api/v1/prediction/pred_abc123xyz for results."
}
{
  "error": "image_url is required"
}
{
  "error": "Invalid API key"
}
{
  "error": "Insufficient credits",
  "credits_remaining": 0
}