Render outdoor products such as pavers and gravel

Indoor or outdoor

Every scene has a setting: indoor or outdoor. You choose it when you add the scene; it is never guessed from the picture. An outdoor scene is read as an outdoor space, so its ground (a patio, a path, a bed or a pool area) is found as a surface that ground cover can go on.

A scene added without a setting is indoor. The setting is shown on the scene in every response.

Add an outdoor scene

Send setting: "outdoor" when you create the scene, by URL or as a form field with an upload:

curl -X POST https://www.skipshoot.com/api/v1/scenes \
  -H "Authorization: Bearer $SKIPSHOOT_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image_url": "https://example.com/yards/back-patio.jpg",
  "name": "Back patio",
  "setting": "outdoor"
}'

{
  "scene": {
    "id": 815,
    "name": "Back patio",
    "origin": "upload",
    "setting": "outdoor",
    "status": "analyzing",
    "image_url": "https://…",
    "surfaces": [],
    "created_at": "2026-10-21T15:10:05.000Z"
  }
}

Products for outdoor scenes

Ground cover (products whose material_type is pavers, gravel, mulch, pebbles or pool) goes only into outdoor scenes, so it is never laid on a living-room floor. Sent with an indoor scene, the render is refused and nothing is charged. Every other product renders into outdoor scenes by the usual rules.

Render ground cover

Once the scene is ready, render it like any other product. Leave out surface_id to use the first ground surface, or name one:

curl -X POST https://www.skipshoot.com/api/v1/renders \
  -H "Authorization: Bearer $SKIPSHOOT_SECRET_KEY" \
  -H "Idempotency-Key: patio-815-pavers-2210" \
  -H "Content-Type: application/json" \
  -d '{
  "scene_id": 815,
  "product_id": 2210,
  "surface_id": "floor_1"
}'

Pictures that work outdoors

• Take the picture in even daylight, without hard shadows across the ground.
• Show the ground you want to change clearly, not hidden under furniture or planting.
• A slightly raised viewpoint, such as from a step or a window, shows more of a patio or bed.

The preparation guides cover paver, gravel, mulch, pebble, pool and plant images.