← All guides

Guide API

Checking images for content and AI generation

Flag images that may break a content policy and tell photographs from generated images, free in the workspace and through the API.

Two of the models answer a question about an image instead of changing it. cv-content-check-v1 says whether an image may fall outside what CraterView allows. cv-real-check-v1 estimates whether an image was made by an image generator rather than captured by a camera.

Running a check

In the workspace, choose Content Check or Real Check, add the image and run it. The answer appears under the picture.

Through the API a check is an ordinary job, and its answer is in the job’s result:

from craterview import CraterView

cv = CraterView(api_key="cv_...")

job = cv.run("surfing.jpg", model="cv-content-check-v1", wait=30)
print(job.result["verdict"])
# passed

job = cv.run("surfing.jpg", model="cv-real-check-v1", wait=30)
print(job.result["verdict"], job.result["generated_probability"])
# real 0.0007

A free job still counts towards your key’s requests per minute. When you check a folder, keep a steady pace, and on a 429 wait as long as its Retry-After header says.

Content Check

The answer is one word, verdict: flagged when the image may fall outside what the service allows, passed when it was checked and nothing was found. There is no score.

Every job on every model gets this same check. A job’s flagged field is its answer for the part of your image the job worked on (all of it, unless you named a region), and for some jobs for the one that came back too; null means they were not all checked. A flag refuses nothing: the job runs and is charged as usual, and the workspace shows a note under the picture. More info on what the platform allows may be found under acceptable use.

We’ve tested many photographs with activities like hiking, surfing, beach volleyball, swimming, bodybuilding, sumo, water polo, yoga and crowded beaches. Four of hiking and surfing:

Four photographs, each marked passed: two hikers with poles on a desert trail among saguaro cacti; five surfers in board shorts riding one breaking wave; four trekkers on a rocky path below a turquoise mountain lake; a woman in a surf top carrying her board along a beach

Photographs via Wikimedia Commons, cropped: BLM Arizona (public domain), Brigitte Bourger (CC BY-SA 4.0), Taabishm2 (CC BY-SA 4.0), Annie Spratt (CC0).

If it flags an image that you think it shouldn’t, write to support@craterview.ai with the job’s id.

Real Check

The answer is two fields. generated_probability is the estimated probability, from 0 to 1, that the image was generated. verdict is that number placed against fixed lines: generated, real, or uncertain between them. Don’t act on uncertain either way, and if you need a stricter or a looser line, draw it on generated_probability.

Four pictures, each with its verdict: a surfer on a breaking wave, real at 0.0007; an Apollo 11 astronaut beside the lunar module after a 4x enhancement, uncertain at 0.3791; a smiling young woman outdoors, made with an image generator, generated at 0.9827; the same woman as a starship captain from the Headshot model, generated at 0.9985

A photograph by Faypearse (CC BY-SA 4.0, via Wikimedia Commons); NASA’s photograph of an Apollo 11 astronaut after cv-enhance-v3 at 4×; a snapshot made with an image generator; and the cv-headshot-v1 result made from it.

Our own results can read as generated

Restore and Enhance draw pixels, and Real Check may notice. Einstein’s 1921 photograph is real; the restored picture on restoring historical photos is generated.

Albert Einstein at a blackboard twice: the faded 1921 photograph, real at 0.2537, and the restored colour version, generated at 0.8338

Two of that guide’s five restorations read as generated: Einstein in colour at 0.83 and the hangar at 0.80. The other three read as real. Of three Apollo 11 photographs enhanced at 4×, two came back real and one uncertain. A generated verdict on a restored photograph is correct, because a model drew its pixels. It says nothing about whether the scene happened. Only the original can tell you that.

What it cannot tell you

Try it on your own file

No signup and no card — a workspace opens for your browser the moment you do.

Open Web App