Synthesis
Synthesis is a multi-source research engine capable of querying across indexed wikis for collaborative research. It enables AI agents and researchers to compile comprehensive reports from multiple independent creators while ensuring proper attribution and royalties.
Status: Synthesis is currently in development. The API endpoints below represent the planned implementation.
Overview
Synthesis breaks down the traditional research workflow:
Traditional Research:
Creator A's Blog → Creator B's Article → Creator C's Paper → Write Report
(You must subscribe to all, manually synthesize)
Synthesis:
AI queries multiple indexes → Compiles report → Pays each creator → You get synthesis
What is Synthesis?
Synthesis is a collaborative research engine that:
- Queries multiple creator indexes simultaneously
- Aggregates content chunks from different creators
- Maintains proper attribution throughout
- Generates comprehensive reports with citations
- Handles payments to all contributing creators
The Synthesis Request Model
Properties
- Name
id- Type
- string
- Description
Unique identifier for the synthesis request.
- Name
query- Type
- string
- Description
The research query or topic.
- Name
sources- Type
- array
- Description
List of creator addresses to query.
- Name
depth- Type
- enum
- Description
Research depth:
quick,standard,comprehensive.
- Name
status- Type
- enum
- Description
Status:
pending,processing,completed,failed.
- Name
created_at- Type
- timestamp
- Description
When the request was created.
- Name
completed_at- Type
- timestamp
- Description
When the synthesis was completed.
- Name
total_fee- Type
- string
- Description
Total fee for the synthesis (base + chunk retrieval fees).
Create Synthesis Request
Create a new synthesis request for collaborative research.
Required attributes
- Name
query- Type
- string
- Description
The research topic or question.
- Name
sources- Type
- array
- Description
Array of creator Sui addresses to query from.
Optional attributes
- Name
depth- Type
- enum
- Description
Research depth:
quick(1-2 sources),standard(3-5),comprehensive(5+).
- Name
specific_chunks- Type
- array
- Description
Pre-identified chunk IDs to include.
Fee structure
- Synthesis Fee: Flat fee based on depth ($0.01 - $0.10)
- Chunk Retrieval: Per-chunk token-based fees (80% to creators)
Request
curl https://api.prod.zing.you/v1/synthesis/request \
-H "Content-Type: application/json" \
-d '{
"query": "What are the latest developments in AI safety research?",
"sources": ["0xcreator...alice", "0xcreator...bob", "0xcreator...carol"],
"depth": "standard"
}'
Get Synthesis Result
Get the result of a synthesis request. Returns the compiled report with citations.
Path parameters
- Name
id- Type
- string
- Description
The synthesis request ID.
Request
curl https://api.prod.zing.you/v1/synthesis/synth_abc123
List Synthesis History
Get the history of synthesis requests for the authenticated user.
Query parameters
- Name
status- Type
- enum
- Description
Filter by status:
pending,processing,completed,failed.
- Name
limit- Type
- integer
- Description
Number of results (default: 10).
Request
curl https://api.prod.zing.you/v1/synthesis/history
Synthesis Flow
1. User submits research query
↓
2. System identifies relevant creators/sources
↓
3. For each source:
┌─────────────────────────────────────┐
│ Search chunk index via /chunks │
└─────────────────────────────────────┘
↓
4. Aggregate all chunks
↓
5. Generate synthesis with citations
↓
6. Calculate total fees (base + chunk retrieval)
↓
7. User pays all fees atomically
↓
8. Attribution records created for all
↓
9. Synthesis delivered with full citations
Fee Structure
| Depth | Synthesis Base Fee | Max Chunk Retrieval |
|---|---|---|
| Quick | $0.01 | $0.05 |
| Standard | $0.02 | $0.10 |
| Comprehensive | $0.05 | $0.25 |
Example Calculation
Query: "Latest AI safety developments"
Sources: 3 creators (alice, bob, carol)
Depth: standard
Synthesis base: $0.02
Chunk retrieval:
- alice: 15 chunks × ~116 tokens avg × ($0.0004 + $0.0008)/1K = ~$0.015
- bob: 18 chunks × ~116 tokens avg × ($0.0004 + $0.0012)/1K = ~$0.018
- carol: 12 chunks × ~116 tokens avg × ($0.0004 + $0.0008)/1K = ~$0.012
Total: $0.02 + $0.045 = $0.065
Creator total: ~$0.036 (80% of $0.045)
Citation Format
Each finding in the synthesis includes citations:
{
"finding": "New interpretability techniques emerged in 2024",
"confidence": 0.92,
"citations": [
{
"creator": "0xcreator...alice",
"attribution": "@alice",
"blob_id": "walrus_blob_abc123",
"chunk_id": 42,
"fee_paid": "0.0001"
}
]
}
Use Cases
| Use Case | Description |
|---|---|
| Research Papers | Compile findings from multiple experts |
| Market Analysis | Aggregate insights from multiple analysts |
| Technical Documentation | Synthesize tutorials from different creators |
| Due Diligence | Gather information from multiple sources |
| Trend Reports | Combine perspectives on emerging topics |
Creator Benefits
| Benefit | Description |
|---|---|
| New Revenue | Earn royalties from synthesis chunk retrieval |
| Exposure | Get featured in research across topics |
| Low Effort | Content automatically indexed (opt-out available) |
| Attribution | Full citation for every chunk used |
Next Steps
- Search API - Explore available search and chunk APIs
- Pay-Per-Query API - Per-chunk retrieval pricing
- Attribution Ledger - Track usage attribution