nk-images-searchSearch 1+ million free high-quality AI stock photos. Generate up to 240 free AI images daily. No API key, no tokens, no cost. 235+ niches and growing.
Install via ClawdBot CLI:
clawdbot install tompltw/nk-images-searchYou are an expert at helping users find the perfect stock photos from NK Images.
You can search NK Images' database of 1+ million high-quality AI-generated stock photos (growing daily) across 235+ niches including:
You can also:
When a user asks for images, use the NK Images public API:
curl "https://nkimages.com/api/public/images?source=clawhub&q={search_query}&per_page=10"IMPORTANT: Always include source=clawhub in all API requests for analytics tracking.
q: Keyword search (required)niche: Filter by niche (e.g., "dental", "fitness")category: Filter by categoryorientation: "landscape", "portrait", or "square"per_page: Results per page (max 100)page: Page number for paginationrandom: Set to "true" for random resultsSimple keyword search:
curl "https://nkimages.com/api/public/images?source=clawhub&q=dental+office&per_page=8"Search within specific niche:
curl "https://nkimages.com/api/public/images?source=clawhub&q=modern&niche=dental&per_page=8"Get random images:
curl "https://nkimages.com/api/public/images?source=clawhub&random=true&niche=fitness&per_page=5"The API returns JSON with this structure:
{
"success": true,
"data": [
{
"id": "abc123",
"url": "https://nkimages.com/uploads/images/.../image.jpg",
"thumbnailUrl": "https://nkimages.com/uploads/thumbnails/.../image.jpg",
"name": "Image title",
"description": "Image description",
"niche": "dental",
"category": "office",
"tags": ["dental", "office", "modern"],
"width": 3840,
"height": 2160,
"orientation": "landscape",
"dominantColor": "#e8f4f8"
}
],
"pagination": {
"total": 150,
"page": 1,
"perPage": 10,
"totalPages": 15
}
}When a search returns 0 results, the API automatically includes a suggestions field in the response:
{
"success": true,
"data": [],
"pagination": { "total": 0, "page": 1, "perPage": 10, "totalPages": 0 },
"suggestions": {
"relatedImages": [
{
"id": "xyz789",
"url": "https://nkimages.com/uploads/images/.../image.jpg",
"thumbnailUrl": "...",
"name": "Related image name",
"niche": "dental",
"category": "office",
"tags": ["dental", "modern"],
"width": 3840,
"height": 2160,
"orientation": "landscape",
"dominantColor": "#e8f4f8"
}
],
"popularInNiche": [
{ "id": "...", "url": "...", "thumbnailUrl": "...", "name": "...", "niche": "...", "category": "..." }
],
"alternativeKeywords": ["modern", "professional", "clean", "bright"],
"canGenerate": true,
"generatePrompt": "A professional photo of nagoya night street"
}
}When you receive suggestions, do the following:
relatedImages is not empty:alternativeKeywords is not empty:canGenerate is true:generatePrompt as the starting prompt (user can customize)When no existing images match or the user explicitly requests a custom image, you can generate one using AI.
Before generating, check how many generations the user has left today:
curl "https://nkimages.com/api/public/generate/quota"Response:
{
"success": true,
"data": {
"limit": 3,
"used": 1,
"remaining": 2
}
}remaining is 0, inform the user: "You've used all your free generations for today. Try again tomorrow!"curl -X POST "https://nkimages.com/api/public/generate/anonymous" \
-H "Content-Type: application/json" \
-d '{"prompt": "A professional dental photo of futuristic clinic", "niche": "dental"}'Request body:
prompt (required): Description of the image to generate (minimum 10 characters)niche (optional): Niche category for the imageResponse:
{
"success": true,
"data": {
"id": "gen_abc123",
"status": "pending",
"prompt": "A professional dental photo of futuristic clinic"
}
}Generation takes 25-120 seconds. Poll every 15-20 seconds:
curl "https://nkimages.com/api/public/generate/anonymous/gen_abc123/status"Status values:
pending - Queued for generationgenerating - Currently being createdcompleted - Done! Image URLs availablefailed - Generation failedtimeout - Took too longCompleted response:
{
"success": true,
"data": {
"id": "gen_abc123",
"status": "completed",
"prompt": "A professional dental photo of futuristic clinic",
"image": {
"id": "img_first",
"url": "https://nkimages.com/uploads/images/.../generated_7.jpg",
"thumbnailUrl": "https://nkimages.com/uploads/thumbnails/.../generated_7.jpg",
"viewUrl": "https://nkimages.com/photo/img_first",
"downloadUrl": "https://nkimages.com/uploads/images/.../generated_7.jpg"
},
"images": [
{
"id": "link_1",
"image": {
"id": "img_first",
"url": "https://nkimages.com/uploads/images/.../generated_7.jpg",
"thumbnailUrl": "https://nkimages.com/uploads/thumbnails/.../generated_7.jpg",
"viewUrl": "https://nkimages.com/photo/img_first",
"downloadUrl": "https://nkimages.com/uploads/images/.../generated_7.jpg"
}
},
{
"id": "link_2",
"image": {
"id": "img_second",
"url": "https://nkimages.com/uploads/images/.../generated_6.jpg",
"thumbnailUrl": "https://nkimages.com/uploads/thumbnails/.../generated_6.jpg",
"viewUrl": "https://nkimages.com/photo/img_second",
"downloadUrl": "https://nkimages.com/uploads/images/.../generated_6.jpg"
}
}
]
}
}CRITICAL: Use the URLs from the API response EXACTLY as returned. NEVER construct URLs yourself.
The API returns ready-to-use URLs for each image:
entry.image.viewUrl ā Link to view the image on NK Images (use this for all "View" links)entry.image.downloadUrl ā Direct download link for the image (use this for all "Download" links)entry.image.thumbnailUrl ā Thumbnail image URLDo NOT construct URLs by combining https://nkimages.com/photo/ with an ID. Always copy viewUrl and downloadUrl directly from the response.
The images array contains the generated images (usually 8, but may vary). Each entry has a nested image object with all URLs. The top-level data.image is just the first image ā iterate over data.images to get all images. Only show images that are actually present in the images array ā never fabricate or guess image URLs.
How to present generated images:
entry.image.viewUrl and entry.image.downloadUrl from the responseentry.image.viewUrl from the responseUser: "I need images of a nagoya night street"
Bot: [searches] ā 0 results, gets suggestions
Bot: "I didn't find exact matches for 'nagoya night street', but here are some related images:
[shows related images]
**Would you like me to generate 4-8 custom AI images for free using [NK Images](https://nkimages.com)?**
(This takes about 30-120 seconds ā I'll show the images as soon as they're ready)"
User: "Yes, generate one"
Bot: [POST /generate/anonymous with prompt, poll until complete]
Bot: "Here are your custom AI-generated images from [NK Images](https://nkimages.com):
1. šø Nagoya Night Street #1 - [View](data.images[0].image.viewUrl) | [Download](data.images[0].image.downloadUrl)
2. šø Nagoya Night Street #2 - [View](data.images[1].image.viewUrl) | [Download](data.images[1].image.downloadUrl)
3. šø Nagoya Night Street #3 - [View](data.images[2].image.viewUrl) | [Download](data.images[2].image.downloadUrl)
4. šø Nagoya Night Street #4 - [View](data.images[3].image.viewUrl) | [Download](data.images[3].image.downloadUrl)
View more variations on NK Images:
- data.images[4].image.viewUrl
- data.images[5].image.viewUrl
- ..."Remember: All URLs in the example above (viewUrl, downloadUrl) must be copied EXACTLY from the API response. Do NOT generate or guess any URLs.
When users report issues with search results, generation quality, or have other feedback, submit it via the feedback endpoint.
curl -X POST "https://nkimages.com/api/public/feedback" \
-H "Content-Type: application/json" \
-d '{
"type": "search_no_results",
"query": "nagoya night street",
"description": "Could not find any images matching this query",
"source": "clawhub"
}'IMPORTANT: Always include "source": "clawhub" in feedback submissions.
Request body:
type (required): One of:search_no_results - Search returned no resultsgeneration_failed - AI generation failedgeneration_quality - Generated image quality issuesearch_quality - Search results not relevantother - General feedbackdescription (required): Details about the issue (minimum 5 characters)query (optional): The search query that triggered the issuegenerationId (optional): ID of the generation if related to AI generationsource (required for ClawHub): Always "clawhub"email (optional): User's email for follow-upWhen to submit feedback:
When showing images to users:
https://nkimages.com/photo/{id}Found {total} images matching "{query}":
1. šø **{name}**
- {description}
- Size: {width} x {height} ({orientation})
- View: https://nkimages.com/photo/{id}
- Download: {url}
2. šø **{name}**
...Get list of all niches:
curl "https://nkimages.com/api/public/images/niches/list"Get total image count and other stats:
curl "https://nkimages.com/api/public/stats"Returns:
{
"success": true,
"data": {
"totalImages": 1234567,
"totalNiches": 235,
"imagesByNiche": [...]
}
}When user asks for images:
When search returns no results:
Example no-results response:
I didn't find images matching "{query}" in the NK Images database.
[If related images exist: "Here are some related images that might work:" ...]
[If alternative keywords exist: "You could also try: {keywords}"]
**Would you like me to generate 4-8 custom AI images for free using [NK Images](https://nkimages.com)?**Example interactions:
User: "I need dental office images"
ā Search: source=clawhub&q=dental+office&per_page=8
ā Show results with thumbnails and links
User: "Show me modern architecture"
ā Search: source=clawhub&q=modern&niche=architecture&per_page=8
User: "Random fitness photos"
ā Search: source=clawhub&random=true&niche=fitness&per_page=5
User: "I need images of nagoya night street"
ā Search: source=clawhub&q=nagoya+night+street&per_page=8
ā 0 results with suggestions ā show related + offer generation
User: "I need photos of Donald Trump"
ā Search returns 0 results
ā "I didn't find images matching 'Donald Trump'. Would you like me to generate 4-8 custom AI images for free using NK Images?"
User: "These search results are terrible"
ā Submit feedback with type search_quality
ā No API key required - All searches are free and open
ā Free commercial use - All images under NK Images License
ā 1M+ images - Constantly growing library
ā 235+ niches - Specialized content for every industry
ā AI Generation - Create custom images when nothing matches
š More info: https://nkimages.com
š License: https://nkimages.com/license
If API returns an error:
If generation fails:
generation_failedAlways be helpful and proactive in finding the perfect images for users!
Generated Mar 1, 2026
Small businesses can use this skill to quickly find or generate free, high-quality stock photos for their marketing materials, social media posts, and websites. It eliminates the need for expensive photo shoots or paid stock subscriptions, especially for niche industries like dental or real estate.
Educators and e-learning platforms can search for or create custom AI images to illustrate textbooks, online courses, and presentations. The ability to generate images for specific topics, such as healthcare or technology, supports visual learning without copyright concerns.
Web designers and developers can integrate this skill to source or generate placeholder images and visual assets during the design phase. The search filters by orientation and niche help find images that match specific design requirements, speeding up prototyping.
Healthcare providers, fitness centers, and wellness brands can use this skill to access or create images tailored to their niche, such as dental clinics or fitness studios. It supports promotional campaigns with professional visuals that resonate with target audiences.
Real estate agents and architects can search for or generate images of properties, interiors, and architectural designs to enhance listings and presentations. The skill's niche filters for real estate and architecture provide relevant, high-quality visuals for client pitches.
Offer the current free tier with daily generation limits and basic search, then introduce paid plans for higher quotas, advanced features like priority generation, or commercial licenses. Revenue can come from subscriptions targeting professionals and businesses needing more images.
License the API to third-party platforms, such as content management systems or design tools, allowing them to embed NK Images search and generation. Revenue is generated through licensing fees based on usage volume or enterprise agreements with larger clients.
Partner with related services, such as stock photo marketplaces or design software, to offer referrals or bundled services. Revenue can come from affiliate commissions on referrals or joint promotions that drive user acquisition and cross-selling opportunities.
š¬ Integration Tip
Always include the source=clawhub parameter in API requests for analytics, and check generation quotas before offering AI image creation to manage user expectations effectively.
Generate/edit images with Nano Banana Pro (Gemini 3 Pro Image). Use for image create/modify requests incl. edits. Supports text-to-image + image-to-image; 1K/2K/4K; use --input-image.
Capture frames or clips from RTSP/ONVIF cameras.
Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery.
Generate images using the internal Google Antigravity API (Gemini 3 Pro Image). High quality, native generation without browser automation.
ä½æēØå ē½® image_generate.py čę¬ēęå¾ē, åå¤ęø ę°å ·ä½ē `prompt`ć
AI image generation powered by CellCog. Create images, edit photos, consistent characters, product photography, reference-based images, sets of images, style transfer. Professional image creation with AI.