# Lotus Network API

Pay-per-call services on Base. No API key, no account, no subscription.
Payment uses x402 V2 (exact scheme, eip155:8453, USDC). Send a request with no
PAYMENT-SIGNATURE header to receive a 402 with terms in the PAYMENT-REQUIRED header.

Base URL: https://lotusnetworkapi.com
OpenAPI: https://lotusnetworkapi.com/openapi.json
Contact: blacklotusfinance.pls@gmail.com

## Endpoints

POST /api/v1/video ($1.50)
  Text-to-video or image-to-video at 1080p, up to five seconds.
  Body: {"prompt": "...", "imageUrl": "https://...", "durationSeconds": 5}
  Returns a jobId immediately. Poll GET /api/v1/jobs/{jobId} (free) until
  status is completed, then collect the MP4 from result.videoUrl.

POST /api/v1/transcribe ($0.50)
  Audio or video to timestamped text. Body: {"audioUrl": "https://..."}
  Optional: language (ISO code), translate (boolean).
  Returns a jobId. Poll GET /api/v1/jobs/{jobId} (free) for the transcript.

GET /api/v1/generate-image?prompt=... ($0.08)
  Text-to-image via FLUX.2 [pro]. Returns base64 plus a durable URL.
  Add &format=binary for raw image bytes instead of JSON.

POST /api/v1/pdf-to-markdown ($0.005)
  Body: {"url": "https://..."} or {"pdf": "<base64>"}
  Returns clean Markdown extracted from the PDF. Scanned PDFs have no text
  layer and will return empty with a note.

GET /api/v1/gas/preflight?horizonMinutes=5 ($0.002)
  Current Base gas conditions and an 80% forecast range for the horizon.
  Computed from eth_feeHistory over the last 300 blocks.

POST /api/v1/gas/decision ($0.003)
  Body: {"stance": "wait"|"execute", "horizonMinutes": 15}
  Journals the decision against a fresh snapshot, returns a decision_id.

GET /api/v1/gas/audit/{decisionId} ($0.002)
  Verifies a journalled decision against the actual base fee at the target
  block. Returns status "pending" if that block has not been reached.

## Free endpoints

GET /api/v1/jobs/{jobId}
  Status and result for a video or transcription job. Free — the work was
  already paid for when the job was created. Poll rather than re-paying.

GET /api/v1/asset/{id}
  Durable URL for a generated MP4. Free.

GET /api/v1/pulse
  Calls served, unique paying wallets, and the calibration record as JSON.

## The gas loop

preflight -> decision -> (wait for horizon) -> audit

This is supporting context for transaction timing, not a trade instruction.
Every figure is derived from public Base RPC data and is reproducible by any
caller against the same chain. The forecast is a mean-reverting log random
walk on realised per-block volatility; the audit reports whether the interval
actually contained the observed value, so calibration is measurable rather
than asserted.