---
title: "Generate new story from API"
method: POST
path: "/v1/stories/"
tags: ["Stories"]
---

# Generate new story from API

`POST /v1/stories/`

## Request

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

## Request body

- object
  - `prompt` string, required
  - `genre` unknown[]
    - unknown
  - `sceneCount` 0 | 4 | 6 | 10 | 16
  - `imgStyle` string
  - `ageGroup` '2-4' | '4-6' | '6-10' | '10-13'
  - `voiceId` string
  - `voiceOption` union
    - 'nova' | 'echo' | 'alloy' | 'fable' | 'onyx'
    - unknown
  - `provider` 'openai' | 'gemini' | 'anyllm'
  - `replyLang` 'Chinese' | 'Spanish' | 'English' | 'Hindi' | 'Arabic' | 'Portuguese' | 'German' | 'French'

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