estimate_forge_price

Estimate the Creative Units price of a forge run before executing it.

Use this tool to check price and verify the workspace has sufficient Creative Units
balance before executing. Does not execute anything.

For forge lifecycle guidance, call get_forge_instructions.

Parameters

Parameter	Type	Default	Description
model_idrequired	string (uuid)	—	Model/style ID to use for generation.
weight	number0–2	1	Style/LoRA strength applied to the model. 1.0 = as trained; lower weakens, higher over-applies the style. Only affects LoRA/adapter-backed styles; ignored for models without a trainable adapter.
width	integer>0	—	Output width in pixels. Pass both width and height whenever the output must have a specific aspect ratio: with either one absent and an init image, editing reference, or first frame attached, the output geometry is taken from that file rather than from a model default.
height	integer>0	—	Output height in pixels. Pass both width and height whenever the output must have a specific aspect ratio: with either one absent and an init image, editing reference, or first frame attached, the output geometry is taken from that file rather than from a model default.
batch_size	integer1–16	4	Number of outputs to estimate price for (1-16).
duration_seconds	number>0	—	Video duration in seconds.
prompt	string	—	Text prompt. Needed for CHARACTER_COUNT pricing models.
generate_audio	boolean	—	Generate audio with video.
upscale_ratio	number	—	Upscale factor (e.g. 2.0, 4.0).
remove_background	boolean	—	Remove the background — pass it here whenever the execute call will, so the estimate reflects the same run.
quality	enum	—	Quality level. One of: low, medium, high
use_ta_pose	boolean	—	Deprecated: use pose_mode. Legacy rig-ready-pose toggle for 3D.
pose_mode	enum	—	Rest pose for a character mesh: A_POSE or T_POSE. Support varies by model. One of: A_POSE, T_POSE
include_textures	boolean	—	Include textures in 3D output.
quad_mesh	boolean	—	Generate quad mesh.
pbr_materials	boolean	—	Generate PBR materials.
low_poly	boolean	—	Generate low-poly mesh.
generate_parts	boolean	—	Generate separate parts.
detailed_geometry	boolean	—	Generate denser, more detailed geometry. Costs extra and only some 3D models support it.
export_uv	boolean	—	Set false to omit UV coordinates from the 3D output.
compress_geometry	boolean	—	Return a geometry-compressed mesh. Only some 3D models support it.
face_limit	integer	—	Face/polygon limit for 3D mesh.
workspace_idrequired	string (uuid)	—	The user's workspace id.