Files
skills/direct-img/SKILL.md
T
multipleof4andClaude Opus 5.5 671d927f63 Docs: Note that ?i= reuses a search for an hour and doesn't count toward the limit
Also bump the main site ?i= max to 40 (free stays 20).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-21 17:11:17 +00:00

31 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: direct-img
description: Embed images anywhere with direct-img.link URLs, where https://direct-img.link/orange+cat returns an image directly. For finding or embedding images, photos, gifs or illustrations in chat, markdown, HTML, docs or web pages, and free.direct-img.link for public domain / CC0 images.
---
# direct-img.link
`https://direct-img.link/<query>` returns an image found by searching for `<query>`. It works anywhere an image URL does.
## URLs
- Words are joined with `+`: `https://direct-img.link/golden+retriever+puppy`
- Literal `.` and `/` are rejected; encode them as `%2E` and `%2F`. Other special characters are percent-encoded as usual. Max 200 characters; case and extra spaces are ignored.
- `?i=N` (1–40, default 1; 1–20 on free) returns the N-th working image for the query. Each `i` is a different image.
- A URL keeps returning the same image for 90 days, then may return a different one.
- With no result or an invalid parameter, a placeholder [bad image](https://direct-img.link/assets/bad.webp) is returned.
- Any URL can be downloaded and viewed to see what it returns.
## Free images
- `https://free.direct-img.link/<query>` returns only images marked public domain or CC0, from Openverse, then Wikimedia Commons. No credit is needed. It has far fewer images than the main host.
- `?src=openverse` or `?src=wikimedia` limits it to one source. `src` and `i` combine in any order.
## Rate limit
- `direct-img.link`: 35 new searches per day per IP
- `free.direct-img.link`: 100 new searches per day per IP
- Only new searches count. Cached URLs keep loading after the limit is hit.
- A search's results are kept for 1 hour, so other `?i=` values of a query searched in the last hour don't count either. If an image is wrong, try `?i=2`, `?i=3`… right away before rewording the query, since a reworded query is a new search.
- Burst: ~10 requests per 10 seconds per IP