API Reference

API Reference

HttpClient

client = HttpClient(
    base_url="https://api.wauldo.com",
    api_key="YOUR_KEY",
    timeout=120,
    headers={"X-Custom": "value"},
)

Method	Description
guard(text, source_context, mode)	Verify claims against sources
rag_upload(content, filename)	Upload text for RAG
upload_file(file_path, title, tags)	Upload PDF/DOCX/images
rag_query(query, top_k)	Query uploaded docs
rag_ask(question, text)	Upload + query in one call
chat_simple(model, message)	Single message chat
chat_stream(request)	SSE streaming chat
list_models()	Available models

MockHttpClient

from wauldo import MockHttpClient

mock = MockHttpClient()
mock.guard("60 days", "14 days")  # rejected (numerical mismatch)
mock.guard("Paris", "Paris")       # verified
mock.rag_upload("text", "f.txt")   # mock doc_id
mock.rag_query("question")         # mock answer