# DeepSynth

> Evidence-grounded intelligence briefs from text or a single URL, paywalled with x402.

## Summary
Turns text or a URL into an evidence-grounded, validated JSON intelligence brief with cited claims, insights, gaps, and action items.

Status: LIVE (Base mainnet) — real USDC settlements
Version: 0.1.0
Public base: https://deepsynth.cs1.com

## Pricing
- Endpoint: POST https://deepsynth.cs1.com/v1/distill
- Price: $0.02 USDC (exact scheme)
- Network: eip155:8453
- payTo: 0x81Ad7741Cf3a27D20eD5Cc900F6090c882f7dfB3
- Facilitator: https://facilitator.payai.network
- Latency: typically 15–60s synthesis; maxTimeoutSeconds 600

## Request
JSON body — exactly one of:
- { "text": "..." }  (max ~15000 chars)
- { "url": "https://..." }  (server fetches main content)

Unauthenticated calls return HTTP 402 with PAYMENT-REQUIRED header.
Agents: sign payment, retry with PAYMENT-SIGNATURE (see x402 protocol / @x402/fetch).

## Response
application/json: { meta, brief }
- brief: one_liner, summary, key_claims, entities, insights, sentiment, gaps_contrarian, action_items, follow_up_questions
- meta: source, model, processing_ms, receipt
- Headers: X-DeepSynth-Version, X-DeepSynth-Processing-Ms (on distill)

## Errors (machine-readable JSON)
- 400 bad_request — missing/invalid body, extraction failed
- 402 — payment required (x402)
- 429 rate_limit_exceeded — per-IP throttle
- 502 synthesis_failed — model output failed Zod after repair
- 502 upstream_error — Venice/network failure
- 503 circuit_open — daily paid call limit exceeded
Shape: { "error", "message", "detail?", "retry_after_s?" }

## Free discovery
- https://deepsynth.cs1.com/
- https://deepsynth.cs1.com/health
- https://deepsynth.cs1.com/openapi.json
- https://deepsynth.cs1.com/.well-known/x402.json
- https://deepsynth.cs1.com/llms.txt

## One-curl (expect 402 without payment)
curl -i -X POST https://deepsynth.cs1.com/v1/distill \
  -H 'Content-Type: application/json' \
  -d '{"text":"Acme opened a plant in Austin with 1200 jobs."}'