Agents

The Reve API is designed to be easy for AI agents to use. Its endpoints take plain text instructions and return predictable JSON, so an agent can generate, edit, and compose images.

What is a SKILL.md file?

A SKILL.md file is a markdown document that teaches an AI agent how to use a particular tool or API. It describes what the tool does, when to reach for it, and how to call it, so the agent can pick up the capability without any additional training. Dropping a skill file into an agent's context is often all it takes to make a new API available to it.

The Reve skill file

We maintain a ready-to-use skill file for the Reve image API. Add it to your agent to give it everything it needs to generate and edit images with Reve.

View the Reve skill file on GitHub →

Using the Reve API from an agent

Agents work best when a tool's contract is described in one place. Point your agent at the endpoints in this documentation, give it an API key, and it can call create and edit for everyday image generation, or the experimental layout endpoints when it needs precise control over composition.