name: sapiom
description: Access paid services (verification, search, AI models, image generation) for AI agents via Sapiom. Use when building agents that need to verify phone/email, search the web, call AI models, or generate images — without setting up vendor accounts.

Sapiom

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

Setup

1. Get your API key from https://app.sapiom.ai/settings

2. Set environment variable:
   bash export SAPIOM_API_KEY="your_key"

3. Install SDK:
   bash npm install @sapiom/axios axios # or npm install @sapiom/fetch

4. Initialize client:
   ```typescript
   // Axios
   import { withSapiom } from "@sapiom/axios";
   import axios from "axios";
   const client = withSapiom(axios.create(), {
   apiKey: process.env.SAPIOM_API_KEY,
   });

// Fetch
import { createFetch } from "@sapiom/fetch";
const fetch = createFetch({ apiKey: process.env.SAPIOM_API_KEY });
```

Services

Endpoints

Verify (2-step flow)

Search (Linkup)

Search (You.com)

AI Models (OpenRouter)

Note: max_tokens is required for cost calculation. Use full model name with provider prefix (e.g., openai/gpt-4o-mini, anthropic/claude-3.5-sonnet).

Images (Fal.ai) — coming soon

Example

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

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

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

// Verify a phone number
const sendResult = await client.post(
  "https://prelude.services.sapiom.ai/verifications",
  { target: { type: "phone_number", value: "+15551234567" } }
);
// After user enters code:
const checkResult = await client.post(
  "https://prelude.services.sapiom.ai/verifications/check",
  { verificationRequestId: sendResult.data.id, code: "123456" }
);

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

Pricing