Using Material Forge in your workflow

Sorceress brings this custom workflow into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.

Generate materials for game art workflows.
Choose a documented material model and inspect its output before applying it to an asset.

Pricing and availability

Pricing varies by action and model; see the actions below. Successful work is billed in Sorceress credits. Defaults and optional inputs can affect the total.

GPT Image 2.5 Flare: 6 credits at defaults
GPT Image 2.5 Sunburst: 6 credits at defaults
GPT Image 2: 5 credits at defaults
GPT Image 1.5: 4 credits at defaults
Nano Banana 2 Lite: 4 credits at defaults
Grok Imagine 2: 4 credits at defaults
Grok Imagine: 6 credits at defaults
Nano Banana 2.1: 9 credits at defaults
Nano Banana 2: 9 credits at defaults
Nano Banana Pro: 18 credits at defaults
Nano Banana: 6 credits at defaults
Seedream 5 Pro: 6 credits at defaults
Seedream 5 Lite: 6 credits at defaults
Seedream 4.5: 6 credits at defaults
Wan 2.7 Image: 5 credits at defaults
Wan 2.7 Image Pro: 10 credits at defaults
Flux 2 Pro: 6 credits at defaults
Z-Image: 3 credits at defaults

Inputs and supported options

promptstring · required

Material description (e.g. "rusty iron", "wet cobblestone", "frosted glass").

modelstring · optional

Image model key (default nano-banana-2). One of: gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2, gpt-image-1.5, nano-banana-2-lite, grok-imagine-2, grok-imagine, nano-banana-2-1, nano-banana-2, nano-banana-pro, nano-banana, seedream-5-pro, seedream-5-lite, seedream-4.5, wan-2.7-image, wan-2.7-image-pro, flux-2-pro, z-image.

seamlessboolean · optional

Generate a seamless tileable texture (default true).

namestring · optional

Material name for the export package.

propertiesobject · optional

PBR property overrides: baseColor, metallic, roughness (or reflection), normalIntensity, tilingX/tilingY, clearcoat, sheen, ior, transmission, opacity, emissiveColor, emissiveIntensity, aoIntensity, …

deriveobject · optional

Map derivation toggles/strengths: normal, roughness, ao, metallic, emissive (each { enabled, … }).

paramsobject · optional

Image-model params (e.g. { resolution: "1K" }). Affects credit cost.

refImagesarray · optional

Optional reference image URLs.

mapSizenumber · optional

Derived map resolution (256–2048, default 1024).

aspectRatiostring · optional

Usually 1:1 for materials.

Workflow actions

Material Forge

Generate a game-ready PBR material from a text prompt: seamless base color + derived normal/roughness/AO/metallic/emissive maps, editable settings (tiling, bump, roughness/reflection, clearcoat, transmission, …), Three.js createMaterial.js helper, and a downloadable package ZIP. Async: returns a jobId — poll GET /api/v1/jobs/:id until succeeded, then read result.maps / result.material.settings / result.packageUrl / result.threejs.

Cost = the chosen image model (same pricing as image_generate). Map derivation is free. Charged only on success.

Material from Image

Derive a full PBR map stack and editable Three.js material settings from an existing base-color image URL. Synchronous / free (no image-generation credits). Returns material.settings, maps, and threejs.createMaterialJs.

0 credits per successful call

API request template

Replace placeholders and choose valid values from the input contract.

POST /api/v1/tools/material_generate
Authorization: Bearer $SORCERESS_API_KEY
Content-Type: application/json

{
  "prompt": "<prompt>"
}

Read the endpoint reference →

Completion, results and billing

Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.

Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.