POST
/
story
curl --request POST \
  --url https://client.camb.ai/apis/story \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form 'title=<string>' \
  --form 'description=<string>' \
  --form source_language=1 \
  --form narrator_voice_id=123 \
  --form chosen_dictionaries=null
{
  "task_id": "<string>"
}

This endpoint generates a story from the uploaded file and initiates a task with the story’s content. To check the status of the task, the /story/{task_id} endpoint can be polled.

Authorizations

​
x-api-key
string
header
required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Body

multipart/form-data

Response

200
application/json
Successful Response

A JSON that contains the unique identifier for the task. This is used to query the status of the end to end dubbing task that is running. It is returned when a create request is made for a story.