---
title: "Enqueue one tile of a tilemap that fits the tiles placed around it (ML /generate/tile). Dev only for now. One GENERATE_IMAGE charge per candidate (Roles: user)"
method: POST
path: "/jobs/generate-tile"
tags: ["Jobs"]
---

# Enqueue one tile of a tilemap that fits the tiles placed around it (ML /generate/tile). Dev only for now. One GENERATE_IMAGE charge per candidate (Roles: user)

`POST /jobs/generate-tile`

## Request

- Base URL: `https://api.ludo.ai/api`
- URL: `https://api.ludo.ai/api/jobs/generate-tile`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ludo/apis/ludo-ai-api/docs/jobs/generate-tile/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- QueueGenerateTilePayload
  - `grid` 'square' | 'square-side' | 'diamond' | 'diamond-true' | 'hex' | 'hex-flat' | 'hex-tilted' | 'hex-flat-tilted', required: The map's grid: top-down squares, side-scroller squares, 2:1 or true isometric diamonds, pointy or flat-top hexes, and both hexes tilted to the 2:1 isometric camera. Every tile of a grid has one size.
  - `neighbors` object: The placed tiles around the new one, by screen direction. Squares and diamonds have all eight; pointy hexes have no up/down, flat-top hexes no left/right (tilted hexes use the names of their top-down grid). Leave out for the first tile of a map.
    - `up` 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.
    - `up-right` 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.
    - `right` 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.
    - `down-right` 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.
    - `down` 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.
    - `down-left` 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.
    - `left` 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.
    - `up-left` 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.
  - `prompt` string: What the tile shows (the change, for an edit). Required for a first tile and an edit; without it the tile continues and joins the tiles around it.
  - `edit_image` 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.
  - `reference_image` 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.
  - `repeat` 'none' | 'horizontal' | 'vertical' | 'all': The tile repeats with itself: horizontal, vertical or all on squares; all on diamonds and hexes, for the first tile only.
  - `art_style` string
  - `n` integer: Number of candidate tiles
  - `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-06** `40c5274c882d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ludo/apis/ludo-ai-api/changes/jobs/generate-tile/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/970a84f6c315?raw)
