# ManyLives Star Map Generator

> ManyLives Star Map Generator is a paid API for AI agents from api.manylives.me, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-17).

Generates an SVG star map showing the night sky as seen from a specific location, date, and time, with constellation lines and labels.

## Facts

- Endpoint: POST https://api.manylives.me/paid/image/star-map?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/manylives-star-map-generator-af7fa0f4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mQut8sMXtdC2hy3ZGMs8t

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 manylives-star-map-generator-af7fa0f4 -d '<json body>'
```

Example prompt: Can you generate a star map SVG showing the night sky as it looked from Sydney (latitude -33.87, longitude 151.21) on December 24, 2026 at 9pm AEDT (Australia/Sydney timezone)? Use the dark style and include constellation lines and names.

## When to prefer this

Choose this endpoint when you need a programmatically generated SVG star map for a specific location and historical or future date — ideal for gift keepsakes, educational tools, event memorabilia, or any use case requiring a machine-readable SVG with metadata like visible star counts and constellation lists. Pay-per-call with no account required makes it suitable for low-volume or one-off agent tasks.

## Known failure modes

- Missing required fields (lat, lon, date) return a 4xx error
- Invalid date format causes a parse error
- Latitude or longitude out of valid range may produce an error or empty sky
- Timezone string not recognized as valid IANA zone returns an error
- Size value outside 600–6000 range may be rejected or clamped
- Conflicting timezone and utc_offset fields may cause ambiguous results

## How this service works

Pay-per-call tools for people building AI agents: live web search and page contents, point-in-time crypto market data and news for backtests (no lookahead), verifiable track records of 1,000 crypto strategies locked on the Base network, company profiles, quick AI and batch prices. Ask us to turn a public website into a JSON endpoint. Pay per call, no account, free trial.

## Output

Returns a JSON object containing a full SVG string of the rendered star map, the count of visible stars, a list of constellation names above the horizon, the computed UTC timestamp, three caption slot labels for custom text overlays, and any rendering notes (e.g. planets and Moon not drawn, no atmospheric refraction).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "string",
   "examples": [
    -33.87
   ],
   "description": "latitude in degrees, north positive (required)"
  },
  "lon": {
   "type": "string",
   "examples": [
    151.21
   ],
   "description": "longitude in degrees, east positive (required)"
  },
  "date": {
   "type": "string",
   "examples": [
    "2026-12-24"
   ],
   "description": "YYYY-MM-DD (required, local date at the place)"
  },
  "size": {
   "type": "string",
   "description": "optional width in px for the SVG viewBox, 600-6000 (default 2400)"
  },
  "time": {
   "type": "string",
   "examples": [
    "21:00"
   ],
   "description": "HH:MM 24-hour local time (default 21:00)"
  },
  "lines": {
   "type": "string",
   "description": "optional true (default) or false for constellation lines"
  },
  "names": {
   "type": "string",
   "examples": [
    true
   ],
   "description": "optional true to label constellations"
  },
  "style": {
   "type": "string",
   "examples": [
    "dark"
   ],
   "description": "optional dark (default), light or ink (no background, for printing on coloured stock)"
  },
  "timezone": {
   "type": "string",
   "examples": [
    "Australia/Sydney"
   ],
   "description": "IANA time zone, e.g. Australia/Sydney (or utc_offset)"
  },
  "utc_offset": {
   "type": "string",
   "description": "e.g. +10:00 (instead of timezone)"
  },
  "show_details": {
   "type": "string",
   "description": "optional true to print the date and coordinates in the first caption line"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lat": -33.87,
  "lon": 151.21,
  "svg": "<svg xmlns=...>",
  "notes": [
   "No atmospheric refraction; planets and the Moon are not drawn."
  ],
  "when_utc": "2026-12-24T10:00:00.000Z",
  "caption_slots": [
   "caption-1",
   "caption-2",
   "caption-3"
  ],
  "visible_stars": 2387,
  "constellations_above_horizon": [
   "Canis Major",
   "Carina",
   "Orion"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/manylives-star-map-generator-af7fa0f4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.manylives.me](https://www.zero.xyz/host/api.manylives.me/llms.txt)