---
title: "GET /assets/sprite/directional-styles"
method: GET
path: "/assets/sprite/directional-styles"
tags: ["Spritesheets"]
---

# GET /assets/sprite/directional-styles

`GET /assets/sprite/directional-styles`

## Request

- Base URL: `https://api.ludo.ai/api`
- URL: `https://api.ludo.ai/api/assets/sprite/directional-styles`
- Auth: API key in header `Authorization`

List the styles Directional Sprites can render a 3D model in, with the perspectives (camera heights) and the eight directions they render from. Each style has an id (pass it as style_id), a label, a description, a family, whether it is pixel art, a thumbnail_url of the style at its defaults, its current version, and its settings: each setting has a name (the key in style_params), a kind (choice, bool or color - a color setting also takes any colour), its options ({label, value}) and its default. advanced_settings work the same way. Free discovery endpoint: it does not charge credits. Use it before previewDirectionalSprites, createDirectionalSprites and createDirectionalStills. Requires an API key (user scope).

## Response `200`

Success

- DirectionalSpriteStylesResponse
  - `styles` DirectionalSpriteStyle[]
    - `id` string: Pass as style_id.
    - `label` string
    - `description` string
    - `family` string
    - `pixel` boolean: Whether the style is pixel art.
    - `thumbnail_url` string: The style at its defaults.
    - `version` integer: The style's current version.
    - `settings` object[]: The style's settings: each has a name (its key in style_params), label, description, kind (choice, bool or color), options ({label, value}) and default.
    - `advanced_settings` object[]: Finer settings, described the same way.
  - `perspectives` string[]
  - `directions` string[]

## Other responses

- `400`: Error

## Changes

- **2026-10-15** `5386c8cd3d81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ludo/apis/ludo-ai-api/changes/assets/sprite/directional-styles/get.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/4efeb12a23c9?raw)