sapiom
Original：🇺🇸 English
Translated
Access paid services (verification, search, AI models, images, audio, browser automation) for AI agents via Sapiom. Use when building agents that need to verify phone/email, search the web, call AI models, generate images, convert text-to-speech, or automate browsers — without setting up vendor accounts.
8installs
Sourcesapiom/skills
Added on
NPX Install
npx skill4agent add sapiom/skills sapiomTags
Translated version includes tags in frontmatterSKILL.md Content
View Translation Comparison →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 and proxies to the underlying vendor API.
{provider}.services.sapiom.aiWhen 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.
typescript
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:
| Service | Base URL |
|---|---|
| Verify | |
| Search (Linkup) | |
| Search (You.com) | |
| AI Models | |
| Images | |
| Audio | |
| Browser | |
Setup
- Get your API key from https://app.sapiom.ai/settings
- Set environment variable:
bash
export SAPIOM_API_KEY="your_key" - Install the SDK:
bash
npm install @sapiom/axios axios # or npm install @sapiom/fetch
Quick Reference
Verify (Prelude)
typescript
// 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)
typescript
await client.post("https://linkup.services.sapiom.ai/v1/search", {
q: "query", depth: "standard", outputType: "sourcedAnswer",
});AI Models (OpenRouter) — OpenAI-compatible
typescript
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)
typescript
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)
typescript
// 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)
typescript
// 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 to any docs URL to get the raw markdown:
.md| HTML Page | Markdown |
|---|---|
| |
| |
For full endpoint details, parameters, and pricing — always fetch the docs.