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.
• Design assets and inspiration. Find real UI references, with style summaries and snippets ready to reuse.
• Search by image. Start from a reference image to find visually similar or related results.

​

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; with the design topic, each result adds a style summary and a reusable HTML snippet.

​

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
}

​

Design references

{
  "inputs": [{ "type": "text", "data": "pricing comparison table, dark theme, SaaS" }],
  "topic": "design",
  "count": 5,
  "html_snippet": { "enable": true, "max_tokens": 5000 }
}

​

Focus sources and time

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

​

Next Steps