# madoromi.fun Dream Interpretation (Full)

> madoromi.fun Dream Interpretation (Full) is a paid API for AI agents from madoromi.fun, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Generates a full Gemini-powered Japanese dream interpretation from a curated dream-motif knowledge base, returning rich symbolic analysis in Japanese

## Facts

- Endpoint: POST https://madoromi.fun/api/agent/interpret/full
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/madoromi-fun-dream-interpretation-full-cfbb5205
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mlZNYNH4-IJI8L1Bdd77X

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 madoromi-fun-dream-interpretation-full-cfbb5205 -d '<json body>'
```

Example prompt: I had a dream last night where I was flying over a flooded city while being chased by a giant white crane — can you get a full dream interpretation from madoromi in Japanese?

## When to prefer this

Choose this endpoint when you need a rich, full-length symbolic dream interpretation in Japanese, powered by a curated dream-motif knowledge base and Gemini. It is preferable over the sibling endpoint when the user wants narrative depth and comprehensive analysis rather than a compact 5-axis profile. Use the async mode (default) for agent pipelines that can poll for results; use sync=true only when the calling client supports long timeouts (60s+). Best suited for users who read Japanese or applications targeting Japanese-speaking audiences.

## Known failure modes

- Dream text too short (under 4 characters) or too long (over 1600 characters) returns validation error
- Timeout if sync=true and client timeout is set below 60 seconds
- Job result not yet ready when polling — status will still show 'processing'
- Expired job ID — result_url may no longer be valid after expires_in_seconds
- Unsupported output_language (only 'ja' is accepted) returns error
- x402 payment failure or insufficient USDC balance prevents job creation

## How this service works

Japanese dream-interpretation agent API. Returns a Gemini-generated full interpretation from madoromi's curated dream-motif knowledge base (result schema agent-dream-insight.full.v1). Japanese output only. Dream text is never stored or logged. Async by default: the paid POST returns a job id in seconds; fetch the result with a plain free HTTP GET (no x402 client) at /api/agent/interpret/result/{job_id} (ready in ~15s). options.sync=true for one sync response (10-20s; client timeout 60s+).

## Output

An async job response containing a job ID, result URL, polling interval, and expiry time (schema: agent-dream-insight.job.v1). After ~15 seconds, fetching the result URL returns a full Japanese-language dream interpretation generated by Gemini using madoromi's dream-motif knowledge base (schema: agent-dream-insight.full.v1). With sync=true, the full interpretation is returned directly in one response after 10–20 seconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "dream": {
   "type": "string",
   "maxLength": 1600,
   "minLength": 4
  },
  "options": {
   "type": "object",
   "properties": {
    "sync": {
     "type": "boolean"
    }
   }
  },
  "persona": {
   "type": "string"
  },
  "output_language": {
   "enum": [
    "ja"
   ],
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/madoromi-fun-dream-interpretation-full-cfbb5205/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from madoromi.fun](https://www.zero.xyz/host/madoromi.fun/llms.txt)