# Draw (draw.milab.es)

> Creates black-and-white, hand-drawn illustrations in the Learning Legendario style and keeps them in a gallery of thousands of images that can be searched by meaning in Spanish or English.

Authentication: `Authorization: Bearer <token>` (tokens are created by the account owner in Settings).

## Access
- [MCP server](https://draw.milab.es/api/mcp): Streamable HTTP, stateless, same Bearer token. Tools: search_illustrations, generate_illustration, convert_image, colorize_illustration, get_illustration, list_collections.
- [REST API docs (Spanish)](https://draw.milab.es/api-docs)
- [OpenAPI 3.1 spec](https://draw.milab.es/api/v1/openapi.json)

## REST endpoints
- GET https://draw.milab.es/api/v1/search?q=…&limit=…&collection=… — semantic + keyword + typo-tolerant search. Search before generating: an existing image may already fit.
- POST https://draw.milab.es/api/v1/generate {"topic", "quality"?, "format"?, "background"?, "reuse"?: "exact"|"similar"|"none"} — takes 30-160 s.
- POST https://draw.milab.es/api/v1/convert {"imageUrl", "detail"?} — redraw any public image in the LL style.
- POST https://draw.milab.es/api/v1/colorize {"imageUrl", "backgroundColor"?} — flat background colour, no AI.
- GET https://draw.milab.es/api/v1/images/{id}, GET https://draw.milab.es/api/v1/collections

## Image URLs
Returned URLs look like https://draw.milab.es/i/{id}.webp (also .png, .avif, ?background=white|transparent). They are public, permanent, and redirect to the current file.