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.
- Choose an agreed policy and representative, authorized adult-photo sample.
- Run new uploads in shadow mode. Your current provider and moderators remain authoritative.
- Compare missed explicit content, false flags and review workload.
- 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.