Retrieve Knowledge

document/retrieve-knowledgeCandidate

Use retrieve-knowledge to extract and process document information for AI agents. Ideal for Claude Code automation, data extraction workflows, and intelligent document analysis tasks.

Open in console

Retail priceinput $2.6e-07

Providerdocument

Capabilityembedding

InterfacePOST /v1/run

Request example

Every paid call needs a unique Idempotency-Key. The same key and payload replay the original result without a second charge.

curl https://router.tycoon.cool/v1/run \
+  -H "Authorization: Bearer $TYCOONROUTER_API_KEY" \
+  -H "Content-Type: application/json" \
+  -H "Idempotency-Key: $(uuidgen)" \
+  -d '{"model":"document/retrieve-knowledge","inputs":{"messages":[{"role":"user","content":"Hello"}]}}'

Response contract

Synchronous routes return the provider result with TycoonRouter request metadata. Async routes return a request ID plus status and cancel URLs.

Header	Purpose
x-request-id	Immutable Router request identity
x-idempotent-replay	True when the response is a replay
x-tycoonrouter-charge-micros	Settled retail charge when available

Production safeguards

Unknown prices, unbounded requests and uncertain provider outcomes fail closed before a second paid dispatch. Usage and wallet events remain queryable from the account page.