Inspect image
LiveUpload an image and get its subjects, actions, composition and style, the details that are unclear, and the hands, props and contact points to keep when you animate it.
Inspect image
Inspect the source image before animation: subjects, style, hands, props and uncertain details.
PNG, JPEG or WebP up to 10 MB, 3 analyses per hour
Files are processed privately and are not published. Analysis sends selected media to an AI model; temporary source files are removed afterward.
Open image generation and editingAPI endpoint
POST /v1/media/image-inspectionAuthenticate with an API key. Download accepts JSON with url and optional max_height; inspection accepts multipart file. Keys stay in memory.
Example outputA real run on a Creative Commons trailer. Use your own link or file to replace it.
Big Buck Bunny trailer (CC) Blender Foundation | www.bigbuckbunny.org — CC BY 3.0, via Wikimedia Commons
How it works
- 01Add an imageA PNG, JPEG or WebP up to 10 MB.
- 02Get the reportSubjects, actions, composition and style, with unclear details called out.
- 03Animate with careHands, props and contact points to keep, and the report as JSON.
Call Inspect image from your code
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/Get an API key
Create a key in the console. It uses the same balance as the playground.
Create a keySend your first request
The same request the playground sends. Set OPENNAN_KEY to your key.
curl https://api.opennan.com/v1/media/image-inspection \ -H "Authorization: Bearer $OPENNAN_KEY" \ -F "[email protected]"Read the result
The result comes back in the same response. The X-Usage-Cost-Usd header says what the call cost.
Errors and how to fix them
401Missing or wrong key
Send the header Authorization: Bearer with a key from the console.
402Balance too low
Add credit in Billing, then send the same call again.
400A value is not accepted
Read error.message: it names the field. Use a value from the parameter table.
429Too many requests
Wait a few seconds and try again, waiting longer after each 429.
Inspect image: questions
How much does Inspect image cost?
You pay for the AI tokens each run uses. The most a run can cost is held from your balance first and the rest goes back. A run that fails before the AI reads your file is not charged; once the AI has read it, the tokens it used are charged even if the run then fails.
How do I call it from my code?
Send POST https://api.opennan.com/v1/media/image-inspection with your API key. The result comes back in the same response.
Can my AI agent use it?
Yes. Point your agent at https://api.opennan.com/llms.txt: it explains this endpoint and every other one.
What happens if a run fails?
A request that fails is not charged. You pay only for the tokens used.