Setup Story

post/story-setup

Request

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

Request body multipart/form-data

filestring 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.

titlestring nullable

A descriptive title for your story, making it easier to identify and organize.

descriptionstring nullable

A brief synopsis of your story, helping to set context and expectations.

source_languagestring required

narrator_voice_idinteger

The identifier of the AI voice that will narrate your story. This determines the tone, accent, and delivery style.

chosen_dictionariesinteger[] 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

Successful Response

run_idinteger

The unique identifier for the run, which was generated during the Story setup process and returned upon task completion.

Example response

{
  "story_details": {
    "target_languages": [
      "es-es",
      "fr-fr"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.