Perspective integrations
Many tools call the Perspective API for you. Here is how to point each one at layahost. Where a tool has a setting for the endpoint, no code changes; where it has the Google URL built in, the change is one line.
Every tool needs a layahost API key from the API keys page in place of the Google key. Scores come from a different model: re-check the thresholds you set in the tool. See Accuracy.
No code changes
Coral by Vox Media
Coral's toxic comment filter has a custom endpoint setting. In the Coral admin, open Configure → Moderation → Perspective toxic comment filter and set:
| Setting | Value |
|---|---|
| Custom endpoint | https://layahost.com/v1alpha1 |
| API key | Your layahost key (lh_…) |
| Model | TOXICITY (or any supported attribute) |
Coral adds /comments:analyze to the endpoint and sends the key as ?key=, which layahost accepts. The option to send moderation decisions back to Perspective keeps working through comments:suggestscore; layahost accepts those calls for free and stores nothing. Coral sends the site's language as a hint: layahost scores other languages too, but is most accurate in English.
dingo
dingo's LLMPerspective evaluator takes the discovery URL as api_url. In its Perspective example that is the PERSPECTIVE_API_URL environment variable:
export PERSPECTIVE_API_KEY="lh_your_key"
export PERSPECTIVE_API_URL='https://layahost.com/$discovery/rest?version=v1alpha1'augustus
The perspective.Perspective detector has an api_url option. augustus only adds ?key= to Google's own URL, so put the key in the URL yourself, and keep api_key set because it is required:
api_key: lh_your_key
api_url: https://layahost.com/v1alpha1/comments:analyze?key=lh_your_key
attrs: [TOXICITY]Your own code with googleapiclient
Change discoveryServiceUrl to https://layahost.com/$discovery/rest?version=v1alpha1 and the key. Single requests and new_batch_http_request() batches both work. Full example in the migration guide.
One-line changes
These tools have the Google address built in. Until they add a setting, change the line below in your copy.
| Tool | File | Change |
|---|---|---|
| Stanford HELM | src/helm/clients/perspective_api_client.py | discoveryServiceUrl to https://layahost.com/$discovery/rest?version=v1alpha1. HELM's batches and its default FLIRTATION attribute work: flirtation_score stays empty. |
| lm-evaluation-harness | lm_eval/tasks/realtoxicityprompts/metric.py | The commentanalyzer.googleapis.com URL to https://layahost.com/v1alpha1/comments:analyze. PERSPECTIVE_API_KEY takes your layahost key. |
| DataFlow | dataflow/serving/google_api_serving.py | discoveryServiceUrl to https://layahost.com/$discovery/rest?version=v1alpha1; GOOGLE_API_KEY takes your layahost key. |
| 4CAT | processors/machine_learning/perspective.py | The discoveryServiceUrl in discovery.build() to https://layahost.com/$discovery/rest?version=v1alpha1; the api.google.api_key setting takes your layahost key. |
| Discourse Perspective plugin | lib/discourse_perspective.rb | GOOGLE_API_DOMAIN to https://layahost.com; the plugin's API key setting takes your layahost key. |
Using a tool that is not listed? Anything that lets you change the host works: replace commentanalyzer.googleapis.com with layahost.com. If it doesn't, write to [email protected] and we will look at it.