BrightShotBrightShot API
Object Manipulation

Edit with natural language

Edit images using natural language instructions. Describe the changes you want to make and AI will apply them while preserving the rest of the image.

POST
/edit
AuthorizationBearer <token>

API key in format: bs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

In: header

image_urlstring

URL of the image to edit

Formaturi
promptstring

Natural language description of the changes to make

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.bright-shot.com/api/v1/edit" \  -H "Content-Type: application/json" \  -d '{    "image_url": "https://example.com/room.jpg",    "prompt": "Change the sofa to blue"  }'
{
  "requestId": "pred_abc123xyz",
  "status": "starting",
  "remainingGenerations": 149
}
{
  "error": "image_url is required"
}
{
  "error": "Invalid API key"
}
{
  "error": "Not enough generations"
}