---
title: "Enqueue a 16-tile Wang set made from seamless tiles (ML /generate/tileset): two terrains blending, or a line over a terrain. The result holds the 4x4 atlas (and its normal map when asked), a preview map and each cell's corner or edge bits. Dev only for now. One GENERATE_TILESET charge (Roles: user)"
method: POST
path: "/jobs/generate-tileset"
tags: ["Jobs"]
---

# Enqueue a 16-tile Wang set made from seamless tiles (ML /generate/tileset): two terrains blending, or a line over a terrain. The result holds the 4x4 atlas (and its normal map when asked), a preview map and each cell's corner or edge bits. Dev only for now. One GENERATE_TILESET charge (Roles: user)

`POST /jobs/generate-tileset`

## Request

- Base URL: `https://api.ludo.ai/api`
- URL: `https://api.ludo.ai/api/jobs/generate-tileset`
- Auth: API key in header `Authorization`

## Request body

- QueueGenerateTilesetPayload
  - `grid` 'square' | 'diamond' | 'diamond-true', required: The map's grid, as for a tile. Input tiles of any size are taken; one that does not repeat seamlessly is refused.
  - `kind` 'terrain' | 'lines': terrain: terrain A blending into terrain B (a corner set). lines: the line in tile_b (road, path, river, fence, wall) over terrain A, or over nothing, in every dead end, straight, turn, T and crossing (an edge set). A lines set needs tile_b.
  - `tile_a` GameImage
    - `tags` string[]
    - `id` string
    - `image_id` string
    - `url` string
    - `type` string
    - `final_score` number, float
    - `nsfw_prob` number, float
    - `similarity` number, float
    - `width` integer
    - `height` integer
    - `game_id` string
    - `hosted_filename` string
    - `icon` boolean
    - `targetSize` integer
    - `seed` integer
    - `embedded` boolean
    - `analysed` boolean
    - `image` string
    - `image_type` string
    - `prompt` string
    - `motion_prompt` string
    - `request_id` string
    - `hints` string[]
    - `selected_genres` string[]
    - `selected_colors` string[]
    - `selected_style` string
    - `selected_perspective` string
    - `is_safe` boolean
    - `platform` string
    - `loading` boolean
    - `original_hints` string[]
    - `genres` string[]
    - `edit_mask` string
    - `edit_mode` string
    - `camera_rotation` integer
    - `camera_elevation` integer
    - `edit_mask_pil_image` PILImage
      - `format` string
      - `format_description` string
    - `pil_image` PILImage
      - `format` string
      - `format_description` string
    - `nsfw` number, float
    - `pose` SpritePose
      - `animation_prompt` string: Animation description for the sprite pose
      - `margin_ratio` number, float: Margin ratio for the sprite animation
      - `margin_ratio_mode` string
      - `name` string: Name of the sprite pose
      - `prompt` string: Prompt description for the sprite pose
    - `render_3d` Sprite3DRender
      - `style_id` string
      - `style_version` integer
      - `style_params` object: Every setting of the style as rendered, by name.
      - `params` object: The renderer's own parameters (e.g. renderer, version).
      - `perspective` string
      - `direction` string
      - `animation_name` string
      - `motion` object: The generated motion that was rendered, when there was one (its Motion id as motion_id, name, prompt and options; never the clip data).
      - `mirror` boolean: Whether the preset or motion was mirrored. Absent on renders without either.
      - `fps` number, float
      - `keep_horizontal_travel` boolean
      - `keep_vertical_travel` boolean
      - `pixel_block` integer
      - `generated_model` object: The model that was rendered (its id, file urls and, from render, history_id - the three_d_asset history entry it came from).
    - `pixel_grid` integer[], nullable: Pixel-art grid dimensions [width, height] the ML detected in (or gave) the image, as on GeneratedVideo. The ML reports it on every image generation; absent when no grid was found and on images saved before it was recorded.
    - `pixel_size` number, float: Pixel art conversion only: the size of one pixel-art pixel, in the source image's pixels (the caller's, or the detected one).
    - `model` string: Id of the model the ML reports for the image (klimt, frida, ...). Absent on images saved before it was kept.
    - `normals` string: URL of the image's normal map (save_normals), a lossless WebP.
  - `tile_b` GameImage
    - `tags` string[]
    - `id` string
    - `image_id` string
    - `url` string
    - `type` string
    - `final_score` number, float
    - `nsfw_prob` number, float
    - `similarity` number, float
    - `width` integer
    - `height` integer
    - `game_id` string
    - `hosted_filename` string
    - `icon` boolean
    - `targetSize` integer
    - `seed` integer
    - `embedded` boolean
    - `analysed` boolean
    - `image` string
    - `image_type` string
    - `prompt` string
    - `motion_prompt` string
    - `request_id` string
    - `hints` string[]
    - `selected_genres` string[]
    - `selected_colors` string[]
    - `selected_style` string
    - `selected_perspective` string
    - `is_safe` boolean
    - `platform` string
    - `loading` boolean
    - `original_hints` string[]
    - `genres` string[]
    - `edit_mask` string
    - `edit_mode` string
    - `camera_rotation` integer
    - `camera_elevation` integer
    - `edit_mask_pil_image` PILImage
      - `format` string
      - `format_description` string
    - `pil_image` PILImage
      - `format` string
      - `format_description` string
    - `nsfw` number, float
    - `pose` SpritePose
      - `animation_prompt` string: Animation description for the sprite pose
      - `margin_ratio` number, float: Margin ratio for the sprite animation
      - `margin_ratio_mode` string
      - `name` string: Name of the sprite pose
      - `prompt` string: Prompt description for the sprite pose
    - `render_3d` Sprite3DRender
      - `style_id` string
      - `style_version` integer
      - `style_params` object: Every setting of the style as rendered, by name.
      - `params` object: The renderer's own parameters (e.g. renderer, version).
      - `perspective` string
      - `direction` string
      - `animation_name` string
      - `motion` object: The generated motion that was rendered, when there was one (its Motion id as motion_id, name, prompt and options; never the clip data).
      - `mirror` boolean: Whether the preset or motion was mirrored. Absent on renders without either.
      - `fps` number, float
      - `keep_horizontal_travel` boolean
      - `keep_vertical_travel` boolean
      - `pixel_block` integer
      - `generated_model` object: The model that was rendered (its id, file urls and, from render, history_id - the three_d_asset history entry it came from).
    - `pixel_grid` integer[], nullable: Pixel-art grid dimensions [width, height] the ML detected in (or gave) the image, as on GeneratedVideo. The ML reports it on every image generation; absent when no grid was found and on images saved before it was recorded.
    - `pixel_size` number, float: Pixel art conversion only: the size of one pixel-art pixel, in the source image's pixels (the caller's, or the detected one).
    - `model` string: Id of the model the ML reports for the image (klimt, frida, ...). Absent on images saved before it was kept.
    - `normals` string: URL of the image's normal map (save_normals), a lossless WebP.
  - `terrain_a` string: A short name of terrain A (lines: the ground), e.g. grass
  - `terrain_b` string: A short name of terrain B (lines: the line in tile_b, e.g. cobble road)
  - `transition` string: What the boundary looks like, e.g. a stone curb. Lines: optional instructions for building the set from the line in tile_b (what its crossings, T junctions, corners or ends look like), or its edges when tile_b is a texture of its material.
  - `shape` 'natural' | 'smooth' | 'jagged' | 'rounded' | 'sharp': The outline: natural (organic), smooth (plain curves), jagged (fine wiggles), rounded (square corners rounded), sharp (straight runs along the grid)
  - `irregularity` number, float: How far the outline wanders. Default 0.7 for natural and jagged, 0 for the others
  - `transition_width` number, float: Half-width of the transition, as a fraction of the tile width
  - `line_width` number, float: Lines: the line's width as a fraction of the tile width. Default 0.3
  - `normal_maps` boolean: Also return the atlas's normal map (atlas.normals)
  - `seed` integer
  - `request_id` string

## Response `202`

Accepted

- JobAcceptedResponse
  - `jobId` string, required
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required
  - `queue_position` integer

## Other responses

- `400`: Error

## Changes

- **2026-11-16** `e6f547381e3f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ludo/apis/ludo-ai-api/changes/jobs/generate-tileset/post.md)

---

[API](https://skmtc.dev/ludo/apis/ludo-ai-api.md) - [All operations](https://skmtc.dev/ludo/apis/ludo-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ludo/apis/ludo-ai-api/revisions/e6f547381e3f?raw)
