Image Search

For AI agents: docs.octen.ai/capabilities/image-search.md

​

Why Octen Image Search

• Visual references for models. Give a model real images to describe, compare, or reason about.
• Search by image. Start from a reference image, passed as a public URL or base64, to find visually similar or related results.
• Ready to display. Results carry the source page, pixel dimensions, and a thumbnail, enough to lay out and render without fetching the full image.
• Sources you choose. Restrict results to the domains you trust, matched against each result’s source page.

​

How It Works

1. Send a text query or a reference image.
2. Octen searches images across the web and ranks them.
3. The response returns ranked image results.

​

Scenarios

​

Find the right image

curl -X POST https://api.octen.ai/image-search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "inputs": [{ "type": "text", "data": "red sports car" }],
    "count": 5
  }'

​

Search by reference image

{
  "inputs": [{ "type": "image", "url": "https://example.com/reference.jpg" }],
  "count": 5
}

​

Focus sources

{
  "inputs": [{ "type": "text", "data": "Mars rover photos" }],
  "include_domains": ["nasa.gov"]
}

​

Next Steps

Last modified on October 13, 2026