curl -X POST https://api.saturn-pay.com/v1/capabilities/reason \
  -H "Authorization: Bearer sk_agt_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Explain quantum computing in one sentence",
    "maxTokens": 100
  }'

curl -X POST https://api.saturn-pay.com/v1/capabilities/search \
  -H "Authorization: Bearer sk_agt_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest AI research",
    "numResults": 5
  }'

curl -X POST https://api.saturn-pay.com/v1/capabilities/read \
  -H "Authorization: Bearer sk_agt_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/article"
  }'

const response = await fetch('https://api.saturn-pay.com/v1/capabilities/reason', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_agt_...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: 'Explain quantum computing in one sentence'
  })
});

const { data, metadata } = await response.json();
console.log(data.content);
console.log(`Cost: ${metadata.chargedUsdCents} cents`);

{
  "data": {
    "content": "Quantum computing harnesses quantum mechanical phenomena like superposition and entanglement to process information in fundamentally new ways.",
    "finishReason": "stop",
    "usage": {
      "promptTokens": 12,
      "completionTokens": 24,
      "totalTokens": 36
    }
  },
  "metadata": {
    "chargedUsdCents": 2,
    "chargedSats": 6,
    "quotedUsdCents": 3,
    "balanceAfter": 998,
    "auditId": "aud_abc123xyz",
    "provider": "openai",
    "model": "gpt-4o",
    "latencyMs": 1234
  }
}

{
  "data": {
    "results": [
      {
        "title": "Latest AI Research Papers",
        "url": "https://arxiv.org/list/cs.AI",
        "snippet": "Recent advances in artificial intelligence...",
        "position": 1
      }
    ],
    "query": "latest AI research",
    "totalResults": 5
  },
  "metadata": {
    "chargedUsdCents": 1,
    "provider": "serper",
    "auditId": "aud_def456"
  }
}

{
  "error": {
    "code": "BUDGET_EXCEEDED",
    "message": "Daily budget exceeded: $5.00 limit reached",
    "details": {
      "dailySpent": 500,
      "dailyCap": 500,
      "quotedCost": 15
    }
  }
}