One policy surface. Real-time or batch.

pip install aetherlab
export AETHERLAB_API_KEY="your-api-key"

from aetherlab import AetherLabClient

client = AetherLabClient()  # reads AETHERLAB_API_KEY

# An AI response you want screened before it ships
ai_response = "Invest all your money in crypto! Guaranteed 10x returns!"

result = client.check_prompt(
    ai_response,
    blacklisted_keywords=["guaranteed returns", "financial advice"],
)

print(result.compliance_status)  # "Non-Compliant"
print(result.is_compliant)       # False
print(result.avg_threat_level)   # probability of policy violation
print(result.rationale)          # why it was flagged

import asyncio
from aetherlab import AsyncAetherLabClient

async def main():
    async with AsyncAetherLabClient() as client:
        result = await client.check_prompt(
            "Hello, how can I help you today?",
            blacklisted_keywords=["violence", "weapons"],
        )
        print(result.compliance_status)  # "Compliant"

asyncio.run(main())

curl -sS -X POST https://api.aetherlab.co/v1/guardrails/prompt/batches \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      "Guaranteed returns with no risk.",
      "Your funds may lose value."
    ],
    "settings": {
      "blacklisted_keyword": "guaranteed returns",
      "reasoning_mode": "medium",
      "risk_tolerance": "medium"
    }
  }'

curl -sS -X POST https://api.aetherlab.co/v1/guardrails/media/batches \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      "https://assets.example.com/campaign.png",
      "50fd109f-4c3a-42b7-92be-14c1d8f89111"
    ],
    "settings": {
      "blacklisted_keyword": "regulated product claim",
      "reasoning_mode": "medium"
    }
  }'

# Copy the "id" from the creation response.
BATCH_ID="33333333-3333-4333-8333-333333333333"

# Poll every 5–10 seconds until status is completed, failed, cancelled, or expired.
curl -sS "https://api.aetherlab.co/v1/batches/${BATCH_ID}" \
  -H "x-api-key: YOUR_API_KEY"

# A terminal status describes processing. Fetch results for item-level verdicts.
curl -sS "https://api.aetherlab.co/v1/batches/${BATCH_ID}/results" \
  -H "x-api-key: YOUR_API_KEY"

from aetherlab import AetherLabClient

client = AetherLabClient()
batch = client.check_prompt_batch(
    [
        "Guaranteed returns with no risk.",
        "Your funds may lose value.",
    ],
    blacklisted_keywords=["guaranteed returns"],
)

batch = client.wait_for_batch(batch)  # polls the server in v1
for item in client.iter_batch_results(batch.id):
    print(item.custom_id, item.result or item.error)

from aetherlab import AsyncAetherLabClient

async with AsyncAetherLabClient() as client:
    batch = await client.check_prompt_batch(
        prompts,
        idempotency_key="docs-async-backfill-001",
        blacklisted_keywords=["guaranteed returns"],
    )
    batch = await client.wait_for_batch(batch)
    page = await client.get_batch_results(batch.id)
    for item in page.items:
        print(item.custom_id, item.result or item.error)

curl -X POST https://api.aetherlab.co/v1/guardrails/prompt \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_prompt": "Invest all your money in crypto! Guaranteed 10x returns!",
    "blacklisted_keyword": "guaranteed returns,financial advice"
  }'

result = client.check_media(
    "photo.png",
    input_type="file",
    blacklisted_keywords=["violence"],
)
print(result.compliance_status)

curl -X POST https://api.aetherlab.co/v1/batches \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: prompt-backfill-001" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "/v1/guardrails/prompt",
    "completion_window": "24h",
    "requests": [
      {
        "custom_id": "prompt-001",
        "method": "POST",
        "url": "/v1/guardrails/prompt",
        "body": {
          "user_prompt": "Guaranteed returns with no risk.",
          "blacklisted_keyword": "guaranteed returns"
        }
      }
    ]
  }'

[
  {
    "custom_id": "media-url-001",
    "body": {
      "input_type": "url",
      "image": "https://assets.example.com/campaign.png"
    }
  },
  {
    "custom_id": "media-file-001",
    "body": {
      "input_type": "file",
      "file_id": "MEDIA_FILE_ID"
    }
  }
]

{
  "object": "list",
  "batch_id": "BATCH_ID",
  "data": [
    {
      "custom_id": "prompt-001",
      "status": "succeeded",
      "response": {
        "status": 200,
        "message": "Prompt Guard Response",
        "data": {"compliance_status": "Non-Compliant"}
      }
    },
    {
      "custom_id": "prompt-002",
      "status": "failed",
      "error": {
        "message": "This item could not be processed."
      }
    }
  ],
  "has_more": false
}