---
title: "Generate new story with character"
method: POST
path: "/v4/stories/"
tags: ["Stories", "V4"]
---

# Generate new story with character

`POST /v4/stories/`

## Request

- Base URL: `http://0.0.0.0:3001/api`
- URL: `http://0.0.0.0:3001/api/v4/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'
  - `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'
  - `setting` string
  - `characterId` string, required

## 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)
