Stateless compound pipeline analysis
Evaluate a multi-stage, multi-class AI pipeline Bill of Materials, per-run trace attribution, compound reliability, and cross-layer spend optimization in memory with no API key and zero retention.
POST /api/v1/pipelinecurl -X POST https://vitna.ai/api/v1/pipeline \
-H "content-type: application/json" \
-d '{
"name": "Deep research report",
"runLabel": "reports",
"monthlyRuns": 10000,
"discoverPeers": true,
"stages": [
{
"id": "search",
"classId": "tooling",
"incumbentSkuId": "tavily/search",
"invocationsPerRun": 6,
"unitProfile": { "toolCallsPerUnit": 1 }
},
{
"id": "parse",
"classId": "extraction",
"incumbentSkuId": "mistral/ocr",
"invocationsPerRun": 8,
"unitProfile": { "ocrPagesPerUnit": 1 }
},
{
"id": "synthesize",
"classId": "model",
"incumbentSkuId": "openai/gpt-5.4",
"invocationsPerRun": 1,
"unitProfile": { "inputTokensPerUnit": 18000, "outputTokensPerUnit": 2200 },
"constraints": {
"qualityFloor": 93.0,
"economicThresholdPct": 15,
"requiresCapabilities": ["tools"]
},
"candidates": ["anthropic/claude-sonnet-4-6"]
}
],
"evidence": [
{ "skuId": "openai/gpt-5.4", "measuredAt": "2026-10-22", "metrics": { "successRatePct": 95.0 } },
{ "skuId": "anthropic/claude-sonnet-4-6", "measuredAt": "2026-10-22", "metrics": { "successRatePct": 94.5 } }
]
}'What is evaluated
Runs `evaluatePipeline` in memory across any of the 10 Witness component classes (model, compute, retrieval, speech, tooling, extraction, translation, image, video, music), plus optional inline privateRates for self-hosted or custom contract SKUs, ledgerRows (x-vitna-run runtime traces), and evidence:
- Cross-layer Bill of Materials: computes per-stage and total
costPerRunUsd,monthlyCostUsd,annualCostUsd,breakdown.byClass,breakdown.byProvider, andbreakdown.provenance(splitting Witness archive prices from inlineprivateRates). - Compound reliability and critical-path latency: computes
compoundSuccessRatePctandcostPerSuccessfulRunUsdwhen every critical-path stage carriessuccessRatePctevidence, and sumscriticalPathLatencyP90Ms. - Two-tier spend optimization: separates verified
decisionReadySwitches(cleared bydecide()) fromexploratoryTests(eligible lower-cost list levers awaiting workload evaluation).
Payloads are never persisted (Cache-Control: no-store). Also exposed to MCP clients as vitna_analyze_pipeline on `POST /api/v1/mcp`.
Response shape
{
"pipeline": {
"id": "inline/pipeline",
"name": "Deep research report",
"orgId": null,
"runLabel": "reports",
"monthlyRuns": 10000,
"stageCount": 3,
"criticalPathStageCount": 3
},
"totals": {
"costPerRunUsd": 0.122,
"monthlyCostUsd": 1220,
"annualCostUsd": 14640,
"pricedStageCount": 3,
"unpricedStageCount": 0,
"measuredQualityStageCount": 1,
"compoundSuccessRatePct": null,
"strictAllCallsSuccessRatePct": null,
"costPerSuccessfulRunUsd": null,
"criticalPathLatencyP90Ms": null,
"latencyComplete": false
},
"breakdown": {
"byClass": [ ... ],
"byProvider": [ ... ],
"provenance": {
"witnessedRunCostUsd": 0.122,
"enteredRunCostUsd": 0,
"witnessedSharePct": 100,
"enteredSharePct": 0,
"mixedProvenance": false,
"pricePeriodIds": [ ... ],
"enteredPriceIds": []
}
},
"bottlenecks": { ... },
"optimization": {
"currentCostPerRunUsd": 0.122,
"optimizedCostPerRunUsd": 0.122,
"verifiedRunSavingsUsd": 0,
"verifiedMonthlySavingsUsd": 0,
"verifiedAnnualSavingsUsd": 0,
"verifiedSavingsPct": 0,
"exploratoryAdditionalRunSavingsUsd": 0.036,
"exploratoryAdditionalMonthlySavingsUsd": 360,
"decisionReadySwitches": [],
"exploratoryTests": [ ... ]
},
"stages": [ ... ],
"runAttribution": null,
"caveats": [ ... ],
"recommendedCommands": [ ... ],
"sentence": "Pipeline Deep research report costs $0.122000 per report ($1220.00/mo across 10,000 reports) across 3 priced stages; ...",
"privacy": "Evaluated in memory with zero retention; inline pipeline stages, private rates, ledger rows, and evaluation figures are never stored.",
"meta": {
"generatedAt": "2026-11-06T00:00:00.000Z",
"source": "database",
"stageCount": 3,
"discoverPeers": true
}
}