---
title: "Generate Ideas"
method: POST
path: "/idea-generator"
---

# Generate Ideas

`POST /idea-generator`

## Request body

- IdeaGeneratorRequest — An API request to the Creative Generator service.
  - `brand_values` string, nullable — If specified, brand values to emphasize in the creative
  - `microseason` string, nullable — If specified, tailor the creative theme to this microseason
  - `num_prompts_per_scene` integer — Generate this many prompts for each scene idea.
  - `num_scenes` integer — Generate this many scene ideas for the given scenario.
  - `product_description` string, nullable — Description of the product to generate.
  - `product_listing_title` string, nullable — Title of the product listing.
  - `temperature` number — LLM temperature parameter, which controls the randomness of the response sampling. With temperature=0, the response should be repeatable. With temperature>0, randomness in the response sampling will allow the model to return different results.

## Response `200`

Successful Response

- IdeaGeneratorResponse
  - `scenes` SceneIdea[], required — A list of the generated scene ideas for this scenario.
    - `prompts` string[], required — A list of generated prompts for this scene.
    - `scene` string, required — The LLM-generated scene idea for the creative background.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/octoml/apis/media-utilities-api.md) · [All operations](https://skmtc.net/octoml/apis/media-utilities-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octoml/media-utilities-api/versions/24ca8e2b43f8/schema)