lowpoly

Generate

Start building a 3D model from a prompt and/or reference images. Poll GET /lowpoly/tasks/{task_id}.

post/lowpoly/generate

Request

  • Base URL: https://api.retrodiffusion.ai/v2
  • URL: https://api.retrodiffusion.ai/v2/lowpoly/generate
  • Auth: none declared. Required headers: X-RD-Token

Headers

Idempotency-Keystring
X-RD-Tokenstring required

Request body

promptstring

What to build, up to 250 characters.

stylestring

A Low-Poly style id from GET /lowpoly/pricing (rd_lowpoly__detailed, rd_lowpoly__blocky, ...). Lite styles (tier 'lite') cost less and are built by a lighter model; the model keeps its style's tier for everything done to it later. Scene styles (tier 'scene': rd_lowpoly__scene_detailed, rd_lowpoly__scene_blocky) build a whole environment instead: modular tiles plus objects (size and reference_models do not apply).

mode'auto' | 'quality' | 'fast'

auto (default): chosen per request - quality, or fast for simple requests. Same price. Lite styles ignore it (their model always runs at one setting).

reference_imagesstring[]

Up to 4 base64 images (PNG, JPEG or WEBP).

reference_modelsstring[]

asset_ids of your own finished Low-Poly models to build into this one: each is placed exactly (same shapes and textures) where the prompt puts it, or adapted to fit. Images and models together: at most 4.

input_palettestring

A palette image (base64 PNG, JPEG or WEBP, like input_palette on /inferences): the model is built with only its colors (up to 256; larger images are reduced). Revisions and animations keep the palette.

custom_idstring

Idempotency key for retries.

chunk_sizeinteger

Scenes: tile (grid cell) size in texels. Omit to pick one from the prompt.

player_heightinteger

Scenes: how tall a character is, in texels. Omit to pick one from the prompt.

layer_heightinteger

Scenes: height of one storey (stacked layer of tiles), in texels. Omit to pick one from the prompt.

Response

Successful Response

statusstring
task_idstring required
request_idstring required
asset_idstring required
operationstring required
costnumber required
sizeinteger required
size_sourcestring
messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.