---
title: "Generate new story"
method: POST
path: "/v2/stories/"
tags: ["Stories", "V2"]
---

# Generate new story

`POST /v2/stories/`

## Request

- Base URL: `http://0.0.0.0:3001/api`
- URL: `http://0.0.0.0:3001/api/v2/stories/`
- Auth: none declared

## Request body

- object
  - `prompt` string, required
  - `genre` unknown[]
    - unknown
  - `sceneCount` 0 | 4 | 6 | 10 | 14 | 16
  - `imgStyle` string
  - `ageGroup` '2-4' | '4-6' | '6-10' | '10-13'
  - `voiceId` string
  - `voiceOption` union
    - 'nova' | 'echo' | 'alloy' | 'fable' | 'onyx'
    - unknown
  - `userImageUrl` union
    - string
    - string
    - unknown
  - `replyLang` 'en-us' | 'zh-cn' | 'es-es' | 'hi-in' | 'ar-sa' | 'pt-br' | 'de-de' | 'fr-fr' | 'ml-in' | 'ta-in' | 'hy-am' | 'fa-ir' | 'bn-bd' | 'ru-ru' | 'id-id' | 'ja-jp'
  - `characters` union
    - string[]
    - unknown
  - `setting` string

## Response `200`

Default Response

---

[API](https://skmtc.dev/storybee/apis/story-bee.md) - [All operations](https://skmtc.dev/storybee/apis/story-bee/llms.txt) - [OpenAPI document](https://skmtc.dev/storybee/apis/story-bee/revisions/d1d0477803c6?raw)