~/docs cat sdks.md

SDKs

The endpoint is one HTTP call, so any client works. The official SDKs are worth the dependency when you would otherwise write the same four things yourself: multipart uploads, one exception per refusal, retries that never re-bill a detection, and webhook signature verification.

install

npm install @scam-ai/sdk     # TypeScript and Node 20+
pip install scamai           # Python 3.9+

TypeScript

import { ScamAI } from "@scam-ai/sdk";

const det = await new ScamAI().detect("suspect.jpg");
if (det.verdict === "LIKELY_AI_MANIPULATED") flagForReview(det.confidence);

Python

from scamai import ScamAI

det = ScamAI().detect("suspect.jpg")
if det["verdict"] == "LIKELY_AI_MANIPULATED":
    flag_for_review(det["confidence"])

Both read SCAMAI_API_KEY from the environment and both return the same envelope this page documents. Full reference on npm and PyPI.

← Quickstart Create a detection →