generate_picture
Create a character, object, or background picture from plain words using Higgsfield credits, with a price confirmation step and optional placement into a shot or the Media bin.
Instructions
Make any picture with Higgsfield (Nano Banana) from words: a character or object (its background is taken off) or a background. 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. put defaults to media (the Media bin). Use the shortcuts generate_character (straight into a shot's cast) or generate_place (straight in as the shot's background) when that's what you want. For a free drawing in the style itself, use draw_character, draw_object or draw_place.
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": {
"kind": "<kind>",
"prompt": "<prompt>"
},
"name": "generate_picture"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| put | No | Where it goes: shot (into the shot), media (the project's Media bin), none (only the generated pictures list). | |
| kind | Yes | character or object (background taken off), or background (a place, no people). | |
| name | No | A short name for it in the project. | |
| shot | No | Shot id (from get_project). Default: the shot on screen. | |
| prompt | Yes | What to draw, in plain words. @1, @2 point at the reference pictures in order. | |
| confirm | No | true only after the person agreed to the price. | |
| quality | No | Default 2k. About 1.5 / 2 / 3 Higgsfield credits. | |
| replace | No | A cast member id in that shot whose picture this replaces. | |
| references | No | Paths of up to 4 pictures on this computer to keep the same person or thing. | |
| from_pictures | No | Ids of pictures made before (generated_pictures) to use as references. |