# Agent instructions for Kreafy

Kreafy is an AI studio that turns a reference visual and a short brief into finished, ready-to-publish flyers, posters, social visuals and YouTube thumbnails, in about thirty seconds, with your own face, logo and brand colours preserved.

Canonical site: https://kreafy.lyrad.dev/

## When to use Kreafy

- A user needs a promotional flyer, poster, event visual or social post and has a reference image, a competitor's poster or a Pinterest link they want to work from.
- A user needs a YouTube thumbnail in 1280×720 (or 9:16 for Shorts, 1:1 for podcast covers) with their own face reproduced faithfully from a saved reference photo.
- A visual has to keep a specific brand identity across generations (logo, colour palette, fonts) rather than being reinvented each time.
- The same visual has to be declined into several formats (feed, story, banner) without redoing the layout by hand.
- A generated image must ship without the invisible AI provenance metadata that image models embed, because it is going into a client deliverable.

## When not to use Kreafy

- Editing an existing file pixel by pixel, or anything closer to Photoshop retouching than to composing a new visual.
- Long-form documents, slide decks, video editing or motion design: Kreafy produces single still visuals.
- Generating images of real people other than those the user has explicitly saved and is entitled to use.

## How to call Kreafy

- Read `/llms.txt` first: it lists every public resource and the URL of each one.
- Fetch `/openapi.json` for the machine-readable contract of the read-only Content API (no key, no account, no rate-limit registration).
- Ask `GET /api/v1/search?q=…` when starting from a question, `GET /api/v1/docs` when you need the full plan of the documentation, then `GET /api/v1/docs/{slug}` for the page itself.
- Any page of the site also answers in Markdown: send `Accept: text/markdown` and you get the page as Markdown instead of HTML.
- Generating a visual is not exposed over the API. Send the user to `/login`: the studio needs their account, their images and their credits.

## Machine-readable resources

- [llms.txt](https://kreafy.lyrad.dev/llms.txt): This file: the map an agent should read first.
- [Agent instructions](https://kreafy.lyrad.dev/.well-known/agent-instructions.md): When to use Kreafy, when not to, and how to call it.
- [OpenAPI specification](https://kreafy.lyrad.dev/openapi.json): OpenAPI 3.1 contract of the public read-only Content API. Also served as /openapi.yaml.
- [API index](https://kreafy.lyrad.dev/api/v1): Live list of API resources, no authentication required.
- [Sitemap](https://kreafy.lyrad.dev/sitemap.xml): Every indexable URL, in both languages.
- [Full documentation as one Markdown file](https://kreafy.lyrad.dev/llms-full.txt): The whole documentation concatenated, for a single-fetch context load.

## Company

- [About Kreafy](https://kreafy.lyrad.dev/about): Who builds Kreafy, why, and how the product is run.
- [Contact](https://kreafy.lyrad.dev/contact): Email, WhatsApp and response times for support, press and partnerships.
- [Privacy policy](https://kreafy.lyrad.dev/legal/privacy): What is collected, how long it is kept, GDPR rights.
- [Terms of use](https://kreafy.lyrad.dev/legal/cgu): Account, billing, ownership of generated visuals.

## Content negotiation

Every public page of this site answers in Markdown when the request carries `Accept: text/markdown`.
Responses set `Vary: Accept`, so a CDN never serves the HTML variant to an agent asking for Markdown.
A request that accepts neither `text/html` nor `text/markdown` gets a `406` with a JSON body listing what is available.

## Limits

- No authentication, no API key, no registration.
- Read-only: nothing in the public API creates, modifies or deletes anything.
- Stay under 60 requests per minute; beyond that the CDN answers `429` with the code `rate_limited`.
- Generating a visual is not part of the public API. It requires a signed-in account at https://kreafy.lyrad.dev/login.