Sapiom

Sapiom

Instant access to paid services with pay-per-use pricing. No vendor account setup required.

Documentation

For detailed, up-to-date endpoint documentation, fetch the markdown docs:

Setup

1. Get your API key from https://app.sapiom.ai/settings
2. Set environment variable:

   export SAPIOM_API_KEY="your_key"
   

Node.js

npm install @sapiom/axios axios

import { withSapiom } from "@sapiom/axios";
import axios from "axios";

const client = withSapiom(axios.create(), {
  apiKey: process.env.SAPIOM_API_KEY,
});

Python (Service Proxy)

No SDK required. Use REST API with Bearer token authentication.

import requests
import os

headers = {
    "Authorization": f"Bearer {os.environ['SAPIOM_API_KEY']}",
    "Content-Type": "application/json"
}

Note: Service Proxy currently supports Verify only. See https://docs.sapiom.ai/md/service-proxy.md

Services

Quick Examples

Search with AI Answer (Node.js)

const { data } = await client.post(
  "https://linkup.services.sapiom.ai/v1/search",
  { query: "quantum computing", depth: "standard", outputType: "sourcedAnswer" }
);
console.log(data.answer);

Verify Phone (Node.js)

// Step 1: Send code
const { data: send } = await client.post(
  "https://prelude.services.sapiom.ai/verifications",
  { target: { type: "phone_number", value: "+15551234567" } }
);

// Step 2: Check code
const { data: check } = await client.post(
  "https://prelude.services.sapiom.ai/verifications/check",
  { verificationRequestId: send.id, code: "123456" }
);

Verify Phone (Python)

# Step 1: Send code
resp = requests.post(
    "https://api.sapiom.ai/v1/services/verify/send",
    headers=headers,
    json={"phoneNumber": "+15551234567"}
)
request_id = resp.json()["verificationRequestId"]

# Step 2: Check code
resp = requests.post(
    "https://api.sapiom.ai/v1/services/verify/check",
    headers=headers,
    json={"verificationRequestId": request_id, "code": "123456"}
)

AI Models (Node.js)

const { data } = await client.post(
  "https://openrouter.services.sapiom.ai/v1/chat/completions",
  {
    model: "openai/gpt-4o-mini",
    messages: [{ role: "user", content: "Hello!" }],
    max_tokens: 100,
  }
);

Pricing

Navigating Documentation

Links within markdown docs use relative paths (e.g., /capabilities/search). To get the markdown version:

Pattern: Prepend /md/ and append .md to any doc path.

Alternative: Use Accept: text/markdown header with the regular URL:

curl -H "Accept: text/markdown" https://docs.sapiom.ai/capabilities/search

Need More Details?

Fetch the markdown documentation for complete endpoint specs, parameters, and examples:

curl https://docs.sapiom.ai/md/capabilities/verify.md