Estimate cost
estimate_costPrice a generation before running it. Asks Higgsfield for an exact figure per format and falls back to a labelled best guess where it can't. Also validates the request. Spends nothing.
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": {
"brief": "<brief>",
"formats": "<formats>"
},
"name": "estimate_cost"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | image | |
| brand | No | The full brand, only when there is no kit for it. brand_id is simpler. | |
| brief | Yes | ||
| crops | No | Starting crop per format for master sizing, e.g. {"9:16": {"x": 0.4, "y": 0.5}}. Change it later with compose_asset at no cost. | |
| model | No | Defaults: recraft-v4.1 for image, kling-3-std for video. See list_models. | |
| video | No | ||
| sizing | No | Images only. master: one render at the native ratio that best covers every format, each format cropped from it (one charge, identical picture in every size). separate: one render per format. Video always renders per format. | master |
| formats | Yes | Social formats, see list_formats | |
| overlay | No | ||
| brand_id | No | A brand kit from list_brands (id or name). Brings the colours, fonts, logo, website and default copy (headline, call to action, small print); use instead of brand. | |
| preset_id | No | Marketing Studio preset from list_marketing_presets. Needs 1 or 2 references. | |
| references | No | Product images or app screenshots for marketing-studio-2 and marketing-studio-flare: public https URLs, studio file paths (uploads/...), or asset ids from the brand kit (get_brand). Product first. | |
| green_screen | No | For a lifestyle shot of someone using the app: the phone or tablet screen comes out plain bright green, so place_screen can put the real app on it (on the still, or on every frame after animate_image). Describe the camera behind the person (seen from behind their shoulder, looking down at the phone), so the screen can face both them and the viewer; then review_shot the result. | |
| text_overlay | No | Bake headline, CTA and logo on afterwards in brand fonts (recommended; models misspell text) | |
| negative_prompt | No |