run.pay Documentation

{
  "agent_id": "agt_your_agent_id",
  ... your service payload
}

from runpay import RunPay

client = RunPay(
    agent_id="agt_your_agent",
    timeout=30,       # seconds (default: 30)
    retries=3        # automatic retries (default: 3)
)

# Call any service by name or UUID
result = client.call("hallucination-detector", payload)

# List available services
services = client.list_services(category="AI")

# Check wallet balance
balance = client.get_balance()

import RunPay from '@runpay/sdk'

const client = new RunPay({
  agentId: 'agt_your_agent',
  timeout: 30000,    // ms
  retries: 3
})

const result = await client.call('hallucination-detector', payload)
const services = await client.listServices({ category: 'AI' })
const balance = await client.getBalance()

from langchain.tools import tool
from runpay import RunPay
import os

client = RunPay(agent_id=os.environ["RUNPAY_AGENT_ID"])

@tool
def check_hallucination(response: str) -> dict:
    """Check if an LLM response contains hallucinations. Returns risk score 0-100."""
    return client.call("hallucination-detector", {"response": response})

@tool
def scan_pii(text: str) -> dict:
    """Detect PII (email, phone, SSN, etc.) in text before storing."""
    return client.call("pii-scanner", {"text": text})

# Use in your agent
tools = [check_hallucination, scan_pii]

from crewai.tools import BaseTool
from runpay import RunPay

client = RunPay(agent_id="agt_your_agent")

class HallucinationDetector(BaseTool):
    name: str = "Hallucination Detector"
    description: str = "Check LLM outputs for hallucination risk"

    def _run(self, response: str) -> str:
        result = client.call("hallucination-detector", {"response": response})
        return f"Risk score: {result['hallucination_score']}/100 ({result['risk_level']})"

import autogen
from runpay import RunPay

client = RunPay(agent_id="agt_your_agent")

def check_hallucination(response: str) -> dict:
    """Check if an LLM response contains hallucinations."""
    return client.call("hallucination-detector", {"response": response})

assistant = autogen.AssistantAgent(
    name="assistant",
    llm_config={
        "functions": [{
            "name": "check_hallucination",
            "description": "Check LLM output for hallucination risk",
            "parameters": {"type": "object", "properties": {"response": {"type": "string"}}}
        }]
    }
)
autogen.register_function(check_hallucination, caller=assistant)

from runpay import RunPay, RunPayError

try:
    result = client.call("hallucination-detector", payload)
except RunPayError as e:
    if e.code == "insufficient_balance":
        add_funds_to_wallet()
    elif e.code == "rate_limited":
        time.sleep(e.retry_after)
    else:
        raise

POST https://api.yoursite.com/your-endpoint
Content-Type: application/json
X-Runpay-Signature: sha256=...
X-Runpay-Call-Id: call_abc123

{
  "agent_id": "agt_caller_agent",
  "call_id": "call_abc123",
  "payload": { ...agent's input... },
  "timestamp": 1735689600
}