relight
Apply a text-described lighting change to a photo-real picture by file path or generated ID, producing a new image while keeping the original; confirm credits before processing.
Instructions
Higgsfield relights a picture photo-real: everything stays, only the light changes (like the Thumbnail studio's Make it real). Give a picture file path or a generated picture id, and the light in words. A new picture is made; the original stays. Spends the person's Higgsfield credits: the first call (without confirm) only returns the price and credits left; ask the person, then call again with the same arguments and confirm: true. Waits up to about 50 s; if it isn't done, call picture_status. The result goes to media, a shot's background, or nowhere. To light a shot in the app itself (free), use light.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"light": "<light>"
},
"name": "relight"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | A generated_pictures id instead of a path. | |
| put | No | Default media. | |
| path | No | Full path of a PNG, JPG or WebP on this computer. Or give id. | |
| shot | No | Shot id (from get_project). Default: the shot on screen. | |
| tall | No | Make it 9:16 instead of 16:9. | |
| light | Yes | The light, like 'warm low sun from the left, soft blue fill'. | |
| confirm | No | true only after the person agreed to the price. | |
| quality | No | Default 2k. About 1.5 / 2 / 3 credits. |