genstory ai story generator

Use when the user wants to generate a story through Genstory with an API key, submit a Genstory story task, poll task status, and return the final Genstory online story URL plus cover image. Also use when the user needs setup guidance for obtaining a key from https://www.genstory.app/api-keys and configuring GENSTORY_API_KEY in their skill or workflow.

Genstory Story Generator

Use this skill when a workflow needs to call Genstory to generate a story and return a hosted story page URL.

Before you start

Tell the user to create an API key in the Genstory user center at https://www.genstory.app/api-keys.
Store that key as GENSTORY_API_KEY.
The intended final result is the online story URL and cover image.

Required flow

Read GENSTORY_API_KEY from the environment or skill config.
Submit a task to POST https://www.genstory.app/api/v1/story-tasks.
Poll GET https://www.genstory.app/api/v1/story-tasks/{task_id} until the task becomes success or failed.
Return the final structured result with:
- story.id
- story.title
- story.url
- story.cover_url
- story.locale

Submit request

Send Authorization: Bearer ${GENSTORY_API_KEY}.

Minimum JSON body:

{
  "prompt": "Write a warm bedtime story about a brave little fox."
}

Recommended fields:

prompt
title
character_name
scenes_count
generation_type: default text
generation_mode: default standard
layout_mode
page_spec
public_visibility

Polling behavior

Treat pending and processing as in progress.
If status is failed, surface the API error clearly.
If status is success, return the hosted story data and encourage the user to open the Genstory URL.

Output contract

Prefer this final shape:

{
  "task_id": "task_uuid",
  "status": "success",
  "story": {
    "id": "story_uuid",
    "title": "Story title",
    "url": "https://www.genstory.app/stories/story-slug",
    "cover_url": "https://cdn.example.com/story-cover.webp",
    "locale": "en"
  }
}

References

For request and response examples, read references/api.md.