Init Task

Create a new comic generation task by providing story input, language, and style information. This step initializes the base story and returns a `task_id`, `chapter_id`, and `story_id`.

• Method & Path: POST /v1/api/stories

• Auth: X-API-Key header required

• Content-Type: multipart/form-data

Headers

Header	Value
X-API-Key	<YOUR_API_KEY>

Request — Form Fields

Field	Type	Required	Constraints / Enum	Description
story_input	string	✅	—	Narrative input (prompt/synopsis) used to bootstrap the story.
style	string	✅	e.g. "manga", "manhwa", "webtoon" (free-text)	Visual style preset.
story_name	string	✅	—	Human-readable story title.
genre	string	✅	e.g. "horror", "fantasy", "romance" (free-text)	Genre label for guidance/metadata.
language	string	✅	Enum: 'en', 'vi'	Language for generation.
quality	string	❌	Enum: 'low', 'medium', 'high'	(Optional) Quality profile for generation (if supported on your backend).

Response — 200 OK

Field	Type	Description
status	string	Top-level API call status, e.g. "success".
data.status	string	Operation result, e.g. "success".
data.message	string	Message, e.g. "Task initialized successfully".
data.task_id	string	Task ID for the init operation.
data.chapter_id	integer	Created chapter ID.
data.story_id	integer	Created story ID.
data.chapter_index	integer	Chapter index (e.g. 0).
data.story_slug	string	Slugified story name.
errors	array	Validation/processing errors (if any).
error_description	string	Error description (if any).
start_time,end_time	string	Server timestamps.
host_of_client_call_request	string	Caller IP observed by server.
total_time_by_second	number	Processing time in seconds.

Example

{
  "data": {
    "status": "success",
    "message": "Task initialized successfully",
    "task_id": "aa1037e3-34f6-491e-ae40-f824a9605649",
    "chapter_id": 3152,
    "story_id": 2934,
    "chapter_index": 0,
    "story_slug": "nguoi-gac-dem-o-ga-cu"
  },
  "errors": [],
  "error_description": "",
  "start_time": "2025-11-05 00:22:56.152987",
  "end_time": "2025-11-05 00:22:56.596000",
  "total_time_by_second": 0.443031,
  "status": "success"
}