Move one photo workflow at a time.

Use a backend-only key and compare results against your current decisions before switching. This API is not a full drop-in replacement for another provider.

  1. Choose an agreed policy and representative, authorized adult-photo sample.
  2. Run new uploads in shadow mode. Your current provider and moderators remain authoritative.
  3. Compare missed explicit content, false flags and review workload.
  4. Switch only after acceptance. Keep errors pending and provide human appeals.

Node.js example

const response = await fetch("https://api.emeraldtrustengine.com/v1/moderate-photo", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.EMERALD_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": uploadId
  },
  body: JSON.stringify({imageBase64: imageBuffer.toString("base64")})
});
const result = await response.json();
if (!response.ok || !result.ok) return keepPending(uploadId);
if (result.decision === "allow") return publishPhoto(uploadId);
if (result.decision === "review") return queueForReview(uploadId);
return rejectWithAppeal(uploadId);

Use the same idempotency key and image for a retry. Retry transient errors with bounded exponential backoff and jitter; respect Retry-After. Do not interpret a score as the probability that a photo is safe. Read the API contract and data handling before integrating.