Skip to main content
POST
/
v1
/
capabilities
/
{capability}
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
  }'

{
  "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
  }
}
Executes a capability (reason, search, read, etc.) and returns the result along with billing metadata.

​
Path Parameters

​
capability
string
required
The capability to execute. One of: reason, search, read, scrape, execute, imagine, speak, transcribe, email, sms

​
Request Body

Request body varies by capability. See capability-specific documentation for details.

​
Common Parameters

​
provider
string
Specific provider to use. If omitted, Saturn chooses the best available.

​
Capability-Specific Parameters

​
prompt
string
required
The text prompt to send to the LLM.
​
model
string
Specific model (e.g., gpt-4o, claude-sonnet-4-20250514)
​
systemPrompt
string
System prompt for context
​
maxTokens
number
Maximum tokens in response
​
temperature
number
Sampling temperature (0-2)

​
Response

​
data
object
Capability-specific result data
​
metadata
object
Billing and execution metadata
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
  }'

{
  "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
  }
}