Analyze and moments pricing: one batched model request

SI
2d ago
+37-37

What changes

recoupable/api#1233 runs full_report's 13 sections, and song moments' descriptions, as one batched model request each. Each pays the $0.05 base once instead of once per call.

WasNow
full_report base$0.65 (13 calls)$0.05 + seconds of sections that returned
full_report 402 gate$0.65$0.05
Moments (describe) gate$0.36$0.06 ($0.01 measurement + $0.05)

Edited:

  • the analyze and moments pricing paragraphs (OpenAPI and reference pages),
  • both 402 descriptions, plus the moments 402 example (required_credits 60000),
  • the required_credits description,
  • the full_report preset and elapsed_seconds descriptions ("one batched request", "one after another"),
  • the credits page.

Also regenerated manifest.json and llms-full.txt, and refreshed the inventory hash. apiSourceCommit is unchanged.

Order

This describes behavior that goes live when api#1233 merges. Merge that first, then this. After both merge, re-pin apiSourceCommit to the api#1233 merge commit, as #35 did for batch and moments.

Checks

pnpm docs:build, pnpm docs:check, pnpm test (145), pnpm type-check, pnpm lint, and refresh-contract-inventory.py --check against the pinned API revision all pass.

🤖 Generated with Claude Code


Summary by cubic

Updates the docs to match recoupable/api#1233, where full_report's 13 sections and song moments' descriptions now run as one batched model request, paying the $0.05 base once.

  • full_report's 402 gate drops from $0.65 to $0.05; moments' gate drops from $0.36 to $0.06.
  • Covers the analyze and moments pricing paragraphs, the 402 descriptions and the moments required_credits example (60000), the required_credits description, the full_report preset and elapsed_seconds descriptions, and the credits page.
  • Refreshed example-cases.json via build-contract-examples.py, regenerated manifest.json and llms-full.txt, and pinned apiSourceCommit to the head of api#1233.

Merge api#1233 first; after it lands, re-pin apiSourceCommit to its merge commit.