isgenai

Python client for the isGenAI check API. Send an image, a public URL, a passage of text or a piece of code to POST https://isgenai.com/v1/check and get back the JSON result: AI-image and AI-text detector evidence, Content Credentials (C2PA), AI labels in metadata, saved generation prompts and known-copy matches, each finding with its source.

• Standard library only (no dependencies), Python 3.8+.
• No API key is needed for the documented public endpoints. Record checks (Content Credentials, AI labels, saved prompts) are unlimited; the public API allows a few AI scans per day per IP address.
• Paid plans (from US$5 a month) add monthly AI scans; pass the key from https://isgenai.com/account as api_key.
• Checks are private by default (privacy="private", public_receipt=False): no public report is created unless you ask for one.

Install

pip install isgenai

Use

import isgenai

# A local image (PNG, JPEG, WebP, AVIF, TIFF, up to 20 MB)
result = isgenai.check_file("picture.png")
print(result["public_result"]["headline"])

# A public image or page URL
result = isgenai.check_url("https://isgenai.com/examples/saved-details/with-saved-details.png")
for item in result["evidence"]:
    print(item["class"], item["outcome"], item["summary"])

# Text
result = isgenai.check_text("Paste the paragraph you want to check here. Longer passages give steadier results.")
print(result["public_result"]["summary"])

# Code
result = isgenai.check_code("def add(a, b):\n    return a + b", language="Python")

Every function returns the parsed JSON as a dict. The shape is documented in the OpenAPI file at https://isgenai.com/openapi.json and on https://isgenai.com/api. Useful keys:

Options

All functions accept privacy ("private" or "public"), public_receipt (bool), api_key, endpoint and timeout. check_file, check_url and check_text also accept deep=True for a slower, more thorough pass where available.

Errors

Non-2xx responses raise isgenai.IsGenAIError with .status, .code and .body:

try:
    isgenai.check_text(text)
except isgenai.IsGenAIError as exc:
    if exc.status == 429:
        print("Daily public scans used up; add an api_key or try tomorrow.")
    else:
        print(exc)

What a result means

A missing Content Credential or label is not proof that a person made the image: metadata is often removed when files are re-saved or uploaded. A detector score is a probabilistic estimate, not a verdict. isGenAI reports exactly what was found and names the source of every finding. Methodology: https://isgenai.com/checker-methodology

License

MIT. Not affiliated with any AI model vendor.