---
title: "Create Story"
method: POST
path: "/story"
tags: ["Apis", "Stories"]
---

# Create Story

`POST /story`

## Request

- Base URL: `https://client.camb.ai/apis`
- URL: `https://client.camb.ai/apis/story`
- Auth: API key in header `x-api-key`

## Request body `multipart/form-data`

- CreateStoryRequestPayload
  - `file` string, binary, required: The text file (`.txt`) or Word document (`.docx`) containing your story content. This document will be used as the basis for the audio book.
  - `title` string, nullable: A descriptive title for your story, making it easier to identify and organize.
  - `description` string, nullable: A brief synopsis of your story, helping to set context and expectations.
  - `source_language` string, required
  - `narrator_voice_id` integer: The identifier of the AI voice that will narrate your story. This determines the tone, accent, and delivery style.
  - `chosen_dictionaries` integer[], nullable: An optional list of dictionary IDs selected by the user. Each entry must be an integer corresponding to a valid dictionary ID. If provided, at least one ID is required.

## Response `200`

Successful Response

- TaskID
  - `task_id` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/camb/apis/camb-api.md) - [All operations](https://skmtc.dev/camb/apis/camb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/camb/apis/camb-api/revisions/40ebeee64850?raw)