---
title: "Populate"
method: POST
path: "/lowpoly/assets/{asset_id}/populate"
tags: ["lowpoly"]
---

# Populate

`POST /lowpoly/assets/{asset_id}/populate`

## Request

- Base URL: `https://api.retrodiffusion.ai/v2`
- URL: `https://api.retrodiffusion.ai/v2/lowpoly/assets/{asset_id}/populate`
- Auth: none declared. Required headers: `X-RD-Token`

Scenes only: make objects (props, plants, creatures) for the scene and place them in it. The prompt
(optional) steers what to make. Makes a new version; split turns the objects into separate models.

## Path parameters

- `asset_id` string, required

## Headers

- `Idempotency-Key` string
- `X-RD-Token` string, required

## Request body

- LowPolyPopulateInput: Scenes: design objects for the environment and scatter them over it.
  - `prompt` string: Optional direction, up to 250 characters, e.g. 'mostly pine trees and boulders'.
  - `add` boolean: Keep the scene's objects (where they are, with their edits and animations) and add new ones around them. Otherwise the new objects replace them.
  - `reference_images` string[]: Up to 4 base64 images.
  - `custom_id` string

## Response `202`

Successful Response

- LowPolyTaskAccepted
  - `status` string
  - `task_id` string, required
  - `request_id` string, required
  - `asset_id` string, required
  - `operation` string, required
  - `cost` number, required
  - `size` integer, required
  - `size_source` string
  - `message` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method not allowed.
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api.md) · [All operations](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/revisions/9c76250e8e2d?raw)