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#

1. Read GENSTORY_API_KEY from the environment or skill config.
2. Submit a task to POST https://www.genstory.app/api/v1/story-tasks.
3. Poll GET https://www.genstory.app/api/v1/story-tasks/{task_id} until the task becomes success or failed.
4. 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:

json

{
  "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:

json

{
  "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.