Docs: Add ai.direct-img.link to direct-img skill

Covers generated images, their 1-1000 ?i= range, the separate 100/day
limit (each new i counts), and the main site's AI fallback past the
last working image.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-21 17:14:01 +00:00
co-authored by Claude Opus 5.5
parent 671d927f63
commit 82d6d9fc32
2 changed files with 12 additions and 5 deletions
+1 -1
View File
@@ -4,7 +4,7 @@ Personal [Claude Code skills](https://code.claude.com/docs/en/skills).
| Skill | What it does |
|---|---|
| [direct-img](direct-img/SKILL.md) | How [direct-img.link](https://direct-img.link) image URLs work, including free (public domain / CC0) images |
| [direct-img](direct-img/SKILL.md) | How [direct-img.link](https://direct-img.link) image URLs work, including free (public domain / CC0) and AI-generated images |
## Install
+11 -4
View File
@@ -1,6 +1,6 @@
---
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.
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, free.direct-img.link for public domain / CC0 images, and ai.direct-img.link for generated images.
---
# direct-img.link
@@ -11,7 +11,7 @@ description: Embed images anywhere with direct-img.link URLs, where https://dire
- 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.
- `?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. If there aren't `i` working images, an AI image is served instead (`bad.webp` on free).
- 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.
@@ -21,10 +21,17 @@ description: Embed images anywhere with direct-img.link URLs, where https://dire
- `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.
## AI images
- `https://ai.direct-img.link/<query>` generates an image instead of searching, so it never comes up empty.
- Images are 512px, soft and painterly: the right colors, setting and mood, but often not the exact object, and faces come out distorted. Use it as a fallback or for abstract/mood images, not when the exact thing matters.
- `?i=N` (1–1000) gives a different image of the same query. `?src=auroraimg-6m` is the only (and default) source.
## 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.
- `ai.direct-img.link`: 100 new images per day per IP
- Each host has its own counter, reset at 00:00 UTC. 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. On `ai.` every new `i` is a new image and counts.
- Burst: ~10 requests per 10 seconds per IP