Firefly -Substance 3DInstall

Summary

Generate AI-enhanced composite images of 3D objects by combining a specified main 3D model with a generated background scene based on a text prompt and mounted 3D sources.

Inputs

• Sources (JSON) (required) — A JSON array defining MountedSource objects indicating 3D assets or spaces to include, such as space IDs or URLs.
• Prompt (required) — Text describing the background scene to generate behind the main 3D object.
• Hero Asset (required) — Path within the mounted sources to the main 3D model file to feature in the composite scene.
• Compose Options — Optional settings to customize the rendering output, including camera selection, style (photo or art), enabling ground plane for shadows, lighting exposure, output image dimensions, reproducibility seeds, AI model version, number of variations to generate, optional scene file, style reference image, and more.

Output shape

a JSON array containing the generated composite images or related job data for each variation requested

The output can include one or multiple variations (1-4) of the composite. Seeds can be specified to reproduce results. Image dimensions are customizable between 1 and 2688 pixels for width and height. The operation runs asynchronously via Adobe Substance 3D Firefly services and requires valid credentials.

Examples

Example 1: Generate a single 2048x2048 photo-style composite of a 'product on a marble table' with shadows, using a GLB model from a specified space ID.

Set Sources with a JSON array referencing a space ID, enter the prompt describing the scene, specify the heroAsset path as the GLB model, and configure Compose Options such as enableGroundPlane: true, contentClass: photo, width and height as 2048.