Python, PHP y JavaScript con los mismos nombres en los tres, Laravel sobre el de PHP, y nada más que instalar.
Python 3.9+, sin dependencias
pip install toxicfilter-sdk
from toxicfilter import Client
tf = Client("tf_live_...")
verdict = tf.text(comment, locales=["en"])
if verdict.blocked:
refuse()
elif verdict.needs_review:
hold(verdict.id, verdict.reasons)PHP 8.1+, ext-curl
composer require edulazaro/toxicfilter-sdk
use ToxicFilter\Client;
$tf = new Client('tf_live_...');
$verdict = $tf->text($comment, ['locales' => ['en']]);
if ($verdict->blocked()) {
return refuse();
}Node 20+, Deno, Bun, Workers
npm install toxicfilter-sdk
import ToxicFilter from 'toxicfilter-sdk'
const tf = new ToxicFilter('tf_live_...')
const verdict = await tf.text(comment, { locales: ['en'] })
if (verdict.blocked) return refuse()Si se supera el límite de peticiones o falla el servidor, se reintenta con esperas cada vez más largas y la misma clave de idempotencia, así que se analiza y se cobra una sola vez. Quedarse sin créditos nunca se reintenta.
Una clave incorrecta, un campo rechazado y una cuenta sin créditos llegan cada uno con su propio tipo y con lo que necesitas para actuar.
Una sola llamada comprueba que un evento lo hemos enviado nosotros antes de que tu código haga nada.
No impone ninguna librería HTTP a tu aplicación. Cada cliente acepta un transporte propio si quieres cambiarlo.
Laravel 12 y 13, sobre el cliente de PHP
composer require edulazaro/laratox
Una fachada en la que cada llamada dice lo que hace, una regla de validación Moderated que invalida el campo cuando ToxicFilter lo bloquea y un fake para tus tests que usa el cliente real sin conexión.
$verdict = ToxicFilter::text($comment->body)
->policy('comments')
->check();
if ($verdict->blocked()) {
return back()->withErrors($verdict->reason());
}
// Or in validation: a block fails the field.
$request->validate([
'body' => ['required', 'string', Moderated::text()],
]);
Los tres clientes cubren toda la API con los mismos nombres de método. En Python, los de dos palabras van en snake_case: image_data(), batch_async(), needs_review.
| Método | Endpoint | Para |
|---|---|---|
| text() | POST /v1/text | Un comentario, una publicación, un mensaje |
| image() · imageData() | POST /v1/image | Una imagen por URL, o sus bytes |
| conversation() | POST /v1/conversation | El último mensaje, juzgado con el hilo anterior |
| name() · email() · signup() | POST /v1/name · /email · /signup | Un registro: nombre, correo y biografía, juntos o por separado |
| url() | POST /v1/url | Un enlace, analizado por su forma, sin descargarlo nunca |
| prompt() | POST /v1/prompt | Texto que va a entrar en tu propio modelo |
| batch() · batchAsync() · batchStatus() · batches() | POST /v1/batch · GET /v1/batches | Hasta 100 al instante, o 1.000 en segundo plano |
| records() · record() · resolve() · feedback() | GET /v1/records · POST …/resolve · …/feedback | La cola de revisión, y avisarnos cuando nos equivocamos |
| statement() · appeal() · resolveAppeal() · transparency() | GET …/statement · POST …/appeal · GET /v1/statements/transparency | Declaraciones de motivos, recursos y la base de datos de la Comisión |
| usage() · ping() · keys() · revokeKey() | GET /v1/usage · /ping · /keys | Créditos que quedan, estado de la clave y del servicio. Gratis |
Cada llamada devuelve un objeto con el veredicto completo y, detrás, la respuesta tal cual. No hay isToxic(): quince categorías y tres decisiones no caben en un booleano.
Cada fallo tiene su propia clase en los tres clientes, así que una cuota agotada nunca se confunde con un límite de peticiones. La diferencia importa: uno significa esperar; el otro, pagar.
Un muro de comentarios construido con cada cliente, desde un formulario hasta un webhook firmado. Cada aplicación es su propio repositorio, lista para clonar o usar como plantilla.
Sin framework: un muro de comentarios en PHP puro que publica, retiene o rechaza cada comentario, explica al autor el motivo y publica los retenidos cuando una persona los aprueba.
Monta un muro de comentarios en Flask que publica, retiene o rechaza cada comentario con su motivo, verifica el webhook de revisión y pasa sus tests sin acceso a la red.
Construye en Express un muro de comentarios que publica, retiene o rechaza cada comentario con su motivo, mantiene la clave en el servidor y verifica el webhook de revisión.
Una regla de validación, una facade y un fake: construye en Laravel un muro de comentarios que publica, retiene o rechaza cada comentario, y publica los retenidos cuando una persona los aprueba.
¿Prefieres HTTP a secas? Todos los endpoints están en la
referencia de la API,
con un curl para cada uno.