Init Task

Python Example

# init_story.py
import os
import requests

BASE = "https://api.mangaka.app/v1/api"
API_KEY = os.getenv("MANGAKA_API_KEY", "YOUR_API_KEY")
HEADERS = {"x-api-key": API_KEY}

# Valid enums:
# language: 'en' | 'vi'
# quality:  'low' | 'medium' | 'high'  (optional)

def init_story():
    """
    Create a new story and its first chapter.
    Endpoint: POST /v1/api/stories
    Content-Type: multipart/form-data
    """
    # Using (None, value) trick to send text fields in multipart/form-data
    files = {
        "story_input": (None, "A short story prompt or synopsis..."),
        "style": (None, "manga"),
        "story_name": (None, "The Night Watchman at the Old Station"),
        "genre": (None, "horror"),
        "language": (None, "en"),  # 'en' or 'vi'
        # "quality": (None, "high"),  # optional: 'low' | 'medium' | 'high'
    }

    response = requests.post(f"{BASE}/stories", headers=HEADERS, files=files, timeout=60)
    response.raise_for_status()
    data = response.json()
    print(data)
    # The response contains: task_id, story_id, chapter_id, chapter_index, story_slug, etc.

if __name__ == "__main__":
    init_story()