# Peyon Story Structure Read

> Peyon Story Structure Read is a paid API for AI agents from peyon.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-29).

Analyzes a logline or synopsis against Vogler's twelve Hero's Journey stages, identifying present/missing stages, protagonist want/need, stakes, gaps, and delivers a sharpened logline.

## Facts

- Endpoint: GET https://peyon.ai/api/story?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/peyon-story-structure-read-2413272a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m6UyWWlCI6NmZ8FFqflnF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability peyon-story-structure-read-2413272a
```

Example prompt: Can you analyze this logline through Vogler's Hero's Journey and tell me which of the twelve stages are present or missing, what my protagonist's want and need are, what the stakes are, and give me a sharper version of the logline? Here it is: 'A disgraced detective returns to her hometown to investigate a string of disappearances and must confront the childhood trauma she buried decades ago.'

## When to prefer this

Choose this endpoint when you need a quick structural editorial pass on a logline or short synopsis (up to 4,000 characters) specifically mapped to Vogler's Hero's Journey framework — ideal for screenwriters, story developers, or writing assistants who want stage-level feedback, protagonist want/need analysis, and an improved logline without generating a full beat sheet. For a complete beat sheet with act breaks and scene-level breakdown, prefer the Peyon Hero's Journey Beat Sheet endpoint. For character archetype analysis, use the Peyon Character Archetype Read endpoint.

## Known failure modes

- Input text exceeds 4,000 character limit — request will be rejected or truncated
- Vague or very short input may yield shallow analysis with few actionable insights
- Non-narrative input (e.g. raw dialogue, character bios without plot) may produce incomplete stage mapping
- Payment not included or invalid — 402 response requiring x402 payment of $0.05 USDC
- Network timeout if the AI model takes too long to respond

## How this service works

A story editor's read of a logline or synopsis through the Hero's Journey (Vogler's twelve stages): which stages are present, implied or missing, protagonist want and need, stakes, the biggest gaps, and a sharper logline. Up to 4,000 characters.

## Output

A structured editorial read covering: which of Vogler's twelve Hero's Journey stages are present, implied, or missing; the protagonist's surface want versus deeper need; the story's stakes; the biggest structural gaps; and a rewritten, sharper logline — all derived from the submitted logline or synopsis text.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "text"
     ],
     "properties": {
      "text": {
       "type": "string",
       "maxLength": 4000
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/peyon-story-structure-read-2413272a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from peyon.ai](https://www.zero.xyz/host/peyon.ai/llms.txt)