---
name: api.getsly.ai
description: api.getsly.ai exposes a single paid endpoint that returns a generated poem object containing a title, author attribution, a line-by-line array, and a line count. It is a single-shot request with no inputs required and no streaming or batch capabilities.
host: api.getsly.ai
---

# api.getsly.ai

api.getsly.ai is a minimal poetry generation API accessed via x402 micropayment. It serves agents or applications that need a ready-made poem on demand without supplying any prompt or parameters. The host returns one poem per call with structured metadata, making it straightforward to embed poem content into downstream text or UI.

## When to use this host

Use this host when an agent needs a single, immediately available generated poem with structured metadata (title, author, lines, line count) and no input configuration. Do not use it for topic-specific or author-specific poem search, bulk poem generation, or streaming poetry feeds — this host has no filtering, querying, or batching capabilities. If an agent needs poems on a specific subject or style, a general-purpose language model or a dedicated creative writing API with prompt support would be more appropriate.

## Capabilities

### Poem Retrieval

Fetches a single generated poem with its title, author, full line array, and line count in one paid request.

- **`fetch-generated-poem`** — Returns a poem object with title, author, lines array, and line count from a paid x402 endpoint.

## Skill reference

### `fetch-generated-poem`

**Poem Forge** — Returns a poem object with title, author, lines array, and line count from a paid x402 endpoint.

*Use when:* Use when an agent needs to retrieve a generated poem, including its title, author attribution, and full line-by-line text content.

*Not for:* Do not use for bulk poem generation, poem search by topic or author, or streaming poetry feeds — this is a single-shot paid request returning one poem.

**Returns:** Returns a JSON array containing one poem object with title, author, a lines array of individual line strings, and a linecount string.

**Example:** `GET https://api.getsly.ai/x402/demo/poem`

---