---
title: "Suggest scenes for a collection"
method: GET
path: "/v1/collections/{id}/scenes/suggestions"
tags: ["Generate"]
deprecated: true
---

# Suggest scenes for a collection

`GET /v1/collections/{id}/scenes/suggestions`

## Request

- Base URL: `https://api.masko.ai`
- URL: `https://api.masko.ai/v1/collections/{id}/scenes/suggestions`
- Auth: HTTP bearer

> **Deprecated.**

Returns AI-generated scene ideas (setting + action + recommended position) tailored to the collection. Use these as payloads for POST `/v1/collections/{id}/generate` with `type: "scene"`. No credit cost.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `variant_id` string, uuid: Use this approved mascot variant for suggestions. Omit for Original.
- `aspect_ratio` '4:3' | '1:1' | '21:9' | '4:5' | '3:4' | '9:16': Aspect ratio to optimize the suggestions for. Defaults to 4:5.
- `count` integer: Number of scene suggestions to return. Defaults to 6, max 10.

## Response `200`

AI-suggested scenes for the collection

- SceneSuggestionsResponse
  - `data` SceneSuggestionsData, required
    - `suggestions` object[], required
      - `name` string, required
      - `emoji` string
      - `scene` string, required
      - `action` string, required
      - `position` string

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict

---

[API](https://skmtc.dev/masko/apis/masko-api.md) · [All operations](https://skmtc.dev/masko/apis/masko-api/llms.txt) · [OpenAPI document](https://skmtc.dev/masko/apis/masko-api/revisions/91eb3006a92f?raw)