images

Images: place, optimise and view photos, and stock photos · Can change or delete · actions: status, generate, edit, style, stock, stock_use, view, place

For reading use images_read, which is read-only and needs no approval: "view", "stock", "status" here are deprecated (still works). Images for the site: the owner's photos, files saved with fs_import and licensed stock photos. Needs no key and costs nothing. "status": what works, the account's image settings and what to do in your app. "view": look at images in the project (paths: files or a folder such as "data/import"): one comes back at 800 px, several as a numbered contact sheet, each with its real size, orientation (after the EXIF turn), file size, dominant colour and the slot the owner uploaded it for. "place": a photo in the project (from: the owner's, or one saved with fs_import) into its slot on a page (file: the page; slot: the data-lf-placeholder label or "#id"; alt: what this photo shows): makes the web versions at the slot's widths, cropped to its shape (its aspect class or width and height, or aspect: "4:3"; focus), and in an HTML page sets the <img>'s src, srcset, sizes, width, height and alt and removes data-lf-placeholder, changing nothing else (a marked box named or shaped like a photo, or a div role="img" becomes an <img> that keeps its class and style); for a component file (JSX, Vue, …) it returns the tag to put in and its line (a div role="img" stand-in counts as a slot). "edit" operation "optimise": any image in the project (from), sized to max_width and compressed for the web; widths: [800, 1600] makes every width a srcset needs in one call and returns the srcset and the <img>; aspect: "4:3" crops it to that shape first. Deprecated, going on 2027-02-09: "generate", "style" and the edit operations other than optimise (remove_background, vectorize, crisp_upscale, creative_upscale, replace_background, variations), which make or change images with Recraft on the account's own Recraft key (Account › Images); until then they still work for an account with a key, when the user asks for Recraft, and its costs are theirs. "stock": licensed photos from Unsplash, with no key or cost to the user (query: the mood or scenery; orientation, color, page): one numbered list with small previews to choose from, each marked by its id ("unsplash:…"); at most two searches per image slot. "stock_use": for every stock photo you put on the site (photo_id as listed, used_on e.g. "home hero", alt): records its credit for the owner and returns the <img> to put in. An Unsplash photo is hotlinked (never save it into the project). No credit is needed on the site. Stock sets the mood and scenery (landscape, town, coast, food in general, textures); it never stands in for the owner's own rooms, work, products, team or customers: those stay data-lf-placeholder until their photos arrive.