In practice, a training shape is the user-facing launch input for trainer jobs. Most users only need to choose a training shape ID such as accounts/fireworks/trainingShapes/qwen3p5-9b-256k and pass it to the API.
A training shape is the recommended launch path for normal trainer jobs. In most cases, pass the full shared shape path accounts/fireworks/trainingShapes/<shape> as training_shape_id, and the SDK resolves the pinned version for you. Advanced compatibility launches can still use manager-level shape refs and direct infra fields, but use that path only when you know the exact hardware and image configuration.
The fireworks account is the shared public shape catalog. Shapes published under accounts/fireworks/trainingShapes/<shape> can be referenced by all users.You do not need to know the versioned shape reference, image tag, GPU layout, or linked deployment shape ahead of time. The API resolves those details internally.
Pick a training shape ID from the available shapes list below. In most cases this should be the full shared path accounts/fireworks/trainingShapes/<shape>.
Pass it as training_shape_id to a cookbook recipe’s TrainerConfig, or to FiretitanServiceClient.from_firetitan_config(...).
Let the SDK resolve the pinned shape version and linked deployment shape.
That is the only shape-specific value you choose yourself.
You can still configure normal training-loop fields such as:
base_model
lora_rank
learning_rate
display_name
Trainer replica count (TrainerConfig.replica_count or trainer_replica_count)
Deployment replica count (DeployConfig.replica_count or replica_count)
Shape-owned infra is locked. Do not try to override accelerator_type, accelerator_count, node_count, custom_image_tag, or the linked deployment shape.
Gradient accumulation is not a trainer-launch setting. To accumulate gradients, call forward_backward... multiple times from your client loop before a single optim_step(...); see Loss Functions.For field-level behavior and dataclass details, see the FiretitanServiceClient and Cookbook Reference.
Use the full training shape ID including the account prefix (for example accounts/fireworks/trainingShapes/qwen3p5-9b-256k). The fireworks account is the shared public account for training shapes, and you do not need to hand-write a versioned training_shape_ref yourself.
Below is a list of the current platform training shapes available under the shared public fireworks account. During Reinforcement Fine-Tuning (RFT), two types of models are often deployed: a policy trainer (which updates its weights) and a reference model (which is forward-only).
Policy Trainer Shapes: These shapes are used for standard Supervised Fine-Tuning (SFT) or as the active policy model during Reinforcement Learning (RL).
Forward-Only / Reference Shapes: These shapes are used for reference models in RL pipelines. They do not require optimizer states or backward passes, and thus often require fewer resources.