sapiom（sapiom 搜索）

Sapiom

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

Documentation

Always fetch the markdown docs for endpoint details, parameters, and examples.

How It Works

The SDK wraps your HTTP client (Axios or Fetch) and automatically handles payment negotiation with Sapiom service gateways. Each service is hosted at {provider}.services.sapiom.ai and proxies to the underlying vendor API.

When to use: Node.js/TypeScript projects. For Python or other languages, use the SDK patterns with standard HTTP clients — the payment flow requires the SDK.

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

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

// Search the web with Linkup
const { data } = await client.post(
  "https://linkup.services.sapiom.ai/v1/search",
  { q: "quantum computing", depth: "standard", outputType: "sourcedAnswer" }
);

Service URLs:

Setup

1. Get your API key from https://app.sapiom.ai/settings
2. Set environment variable: export SAPIOM_API_KEY="your_key"
3. Install the SDK: npm install @sapiom/axios axios # or npm install @sapiom/fetch

Quick Reference

Verify (Prelude)

// Send code
await client.post("https://prelude.services.sapiom.ai/verifications", {
  target: { type: "phone_number", value: "+15551234567" },
});
// Check code
await client.post("https://prelude.services.sapiom.ai/verifications/check", {
  verificationRequestId: "id-from-send", code: "123456",
});

Search (Linkup)

await client.post("https://linkup.services.sapiom.ai/v1/search", {
  q: "query", depth: "standard", outputType: "sourcedAnswer",
});

AI Models (OpenRouter) — OpenAI-compatible

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

Images (Fal.ai)

await client.post("https://fal.services.sapiom.ai/v1/run/fal-ai/flux/dev", {
  prompt: "A mountain landscape at sunset", image_size: "landscape_4_3",
});

Audio (ElevenLabs)

// TTS — returns binary audio
await client.post(
  "https://elevenlabs.services.sapiom.ai/v1/text-to-speech/EXAVITQu4vr4xnSDxMaL",
  { text: "Hello world", model_id: "eleven_multilingual_v2" },
  { responseType: "arraybuffer" }
);

Browser (Anchor)

// Extract content
await client.post("https://anchor-browser.services.sapiom.ai/v1/tools/fetch-webpage", {
  url: "https://example.com", format: "markdown",
});
// Screenshot
await client.post("https://anchor-browser.services.sapiom.ai/v1/tools/screenshot", {
  url: "https://example.com", width: 1280, height: 720,
});

Navigating Documentation

Append .md to any docs URL to get the raw markdown:

For full endpoint details, parameters, and pricing — always fetch the docs.