01
Free
get-dataset-status
Manifest, freshness, pinned source, counts and every exact slice ID.
Request body
{"input":{}}Response data
manifest · source · sliceIds · packageVersions
POST /api/agent/entrypoints/get-dataset-status/invoke
Lucid Agents API
Evidence that machines can buy one question at a time.
One server-only runtime owns discovery, validation, payment and execution. Next.js route modules delegate directly to its canonical handlers.
Base path
/api/agentPayment railx402 · Base Sepolia
AssetUSDC
Response ceiling< 1 MiB
02
Free
preview-inference-chips
Up to five verified rows for one optional exact slice.
Request body
{"input":{"sliceId":"v6.0-closed-gpt-oss-120b-offline-official-default-tokens-per-second"}}Response data
slice · comparability · rows[0…5]
POST /api/agent/entrypoints/preview-inference-chips/invoke
03
$0.02
rank-inference-chips
Full exact-slice ranking with filters, grouping and bounded pagination.
Request body
{"input":{"sliceId":"v6.0-closed-gpt-oss-120b-offline-official-default-tokens-per-second","metricView":"official","grouping":"best-per-accelerator","page":1,"pageSize":20}}Response data
slice · comparability · total · globally ranked rows
POST /api/agent/entrypoints/rank-inference-chips/invoke
04
$0.03
compare-inference-chips
Compare 2–8 accelerator slugs in one slice; deltas require an explicit baseline.
Request body
{"input":{"sliceId":"v6.0-closed-gpt-oss-120b-offline-official-default-tokens-per-second","acceleratorSlugs":["amd-instinct-mi355x-amd-instinct-mi355x-288gb-hbm3e","nvidia-b300-nvidia-b300-sxm-270gb"],"baselineSlug":"amd-instinct-mi355x-amd-instinct-mi355x-288gb-hbm3e","metricView":"official"}}Response data
rows · missing-evidence reasons · baseline deltas
POST /api/agent/entrypoints/compare-inference-chips/invoke
x402 flow
Discover → challenge → settle → invoke
- 01
Read entrypoint discovery or the agent card.
- 02
Call a paid route without proof and receive an explicit 402 offer with exact price and network.
- 03
Settle USDC on Base Sepolia through the configured facilitator and repeat with the same idempotency key.
- 04
Lucid verifies payment before handler execution and returns a schema-validated result.
Required service states
Failure is a documented response, not an empty screen.
Source-bound skeleton; controls remain labeled.
No incompatible fallback rows.
Missing sources and reasons stay visible.
400 with field-level Zod issues.
Exact x402 offer; never silently free.
Retryable, idempotent, no phantom result.
Receipt plus source hashes.
Snapshot remains pinned, age explicit.
@lucid-agents/core@5.0.0@lucid-agents/http@4.0.0@lucid-agents/payments@5.0.0Without complete payment configuration, free endpoints boot and paid endpoints fail closed. They never execute as free operations.