---
title: "Save the look a 3D model renders as a sprite with (style, its settings, camera) on the model, or clear it by leaving `look` out. Returns the look as saved (Roles: user)."
method: POST
path: "/games/sprite3d/look"
tags: ["Games"]
---

# Save the look a 3D model renders as a sprite with (style, its settings, camera) on the model, or clear it by leaving \`look\` out. Returns the look as saved (Roles: user).

`POST /games/sprite3d/look`

## Request

- Base URL: `https://api.ludo.ai/api`
- URL: `https://api.ludo.ai/api/games/sprite3d/look`
- Auth: API key in header `Authorization`

## Request body

- Sprite3DLookPayload
  - `model_id` string, required: The 3D model's history id (its three_d_asset entry, keyed by image.id).
  - `look` Sprite3DLook
    - `style_id` string
    - `style_version` integer
    - `style_params` object: The style's settings that differ from its defaults, by name.
    - `perspective` 'horizon' | 'low' | 'isometric' | 'high' | 'top'
    - `direction` 'S' | 'SW' | 'W' | 'NW' | 'N' | 'NE' | 'E' | 'SE': Where the camera stands around a character facing S.
    - `saved_at` integer: When it was saved (unix seconds). Set by the server.
    - `preview_url` string: The look's preview (an mp4 of the saved view), shown in place of the model's turntable. Set by the server from Sprite3DLookPayload.preview_video.
  - `preview_video` string: The preview of this look (the mp4 data uri /games/sprite3d/preview answered for its view), stored as the look's preview_url. Left out, the look has no preview.

## Response `200`

Success

- Sprite3DLook
  - `style_id` string
  - `style_version` integer
  - `style_params` object: The style's settings that differ from its defaults, by name.
  - `perspective` 'horizon' | 'low' | 'isometric' | 'high' | 'top'
  - `direction` 'S' | 'SW' | 'W' | 'NW' | 'N' | 'NE' | 'E' | 'SE': Where the camera stands around a character facing S.
  - `saved_at` integer: When it was saved (unix seconds). Set by the server.
  - `preview_url` string: The look's preview (an mp4 of the saved view), shown in place of the model's turntable. Set by the server from Sprite3DLookPayload.preview_video.

## Other responses

- `400`: Error
- `404`: No such 3D model of the caller's

## Changes

- **2026-10-11** `8a65afefcc7a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ludo/apis/ludo-ai-api/changes/games/sprite3d/look/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/4efeb12a23c9?raw)