Create Story

import requests
import json

# Your API authentication
headers = {
    "x-api-key": "your-api-key",  # Replace with your actual API key
}

# Define your story parameters
title = "The Midnight Garden"
description = "A mysterious tale of discovery and wonder"
source_language = "en-us"  # Locale tag. Numeric IDs (e.g. 1) still work but are deprecated. See /source-languages.
narrator_voice_id = 147320  # Example

# Function to submit a story creation request
def create_story(file_path, title, description, source_language, narrator_voice_id):
    """
    Submits a new story creation task and returns the task ID for tracking.

    Parameters:
    - file_path: Path to the .txt or .docx file containing story content
    - title: Title of the story
    - description: Brief description of the story
    - source_language: Locale tag (e.g. "en-us") for the story content; numeric IDs still work but are deprecated
    - narrator_voice_id: ID of the voice that will narrate the story
    """
    try:
        # Prepare the multipart form data
        files = {
            'file': (file_path.split('/')[-1], open(file_path, 'rb'))
        }

        data = {
            'title': title,
            'description': description,
            'source_language': source_language,
            'narrator_voice_id': narrator_voice_id
        }

        # Submit the request
        response = requests.post(
            "https://client.camb.ai/apis/story",
            headers=headers,
            files=files,
            data=data
        )

        # Verify the request was successful
        response.raise_for_status()

        # Extract the task ID from the response
        result = response.json()
        task_id = result.get("task_id")

        print(f"Story creation task submitted successfully! Task ID: {task_id}")
        return task_id

    except requests.exceptions.RequestException as e:
        print(f"Error submitting story creation task: {e}")
        if hasattr(e, 'response') and e.response is not None:
            print(f"Response content: {e.response.text}")
        return None
    finally:
        # Make sure to close the file
        if 'files' in locals() and 'file' in files:
            files['file'][1].close()

# Call the function with your story file
file_path = "path/to/your/story.docx"  # Replace with your actual file path
task_id = create_story(file_path, title, description, source_language, narrator_voice_id)

def check_story_status(task_id):
    """
    Checks the status of a story creation task.
    Returns the current status and any available result information.

    Parameters:
    - task_id: The ID of the story creation task to check
    """
    if not task_id:
        print("No task ID provided.")
        return None

    try:
        response = requests.get(
            f"https://client.camb.ai/apis/story/{task_id}",
            headers=headers
        )

        # Verify the request was successful
        response.raise_for_status()

        # Parse the status information
        status_data = response.json()
        print(f"Current status: {status_data['status']}")

        # If the story is complete, display the results
        if status_data['status'] == "SUCCESS":
            print("Story creation completed successfully!")
            print(f"Story URL: {status_data.get('story_url')}")

        return status_data

    except requests.exceptions.RequestException as e:
        print(f"Error checking story status: {e}")
        return None

# Check the status of your story creation task
status_info = check_story_status(task_id)