reve-ai

Generate, edit, and remix images using the Reve AI API. Use when creating images from text prompts, editing existing images with instructions, or combining/remixing multiple reference images. Requires REVE_API_KEY or REVE_AI_API_KEY environment variable.

7 stars

byDemerzels-lab

View on GitHub Installation ↓

Best use case

reve-ai is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Teams using reve-ai should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/reve-ai/SKILL.md --create-dirs "https://raw.githubusercontent.com/Demerzels-lab/elsamultiskillagent/main/public/skills/dpaluy/reve-ai/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/reve-ai/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How reve-ai Compares

Feature / Agent	reve-ai	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Reve AI Image Generation

Generate, edit, and remix images using Reve's AI API.

## Prerequisites

- Bun runtime
- `REVE_API_KEY` or `REVE_AI_API_KEY` environment variable set

## Quick Usage

```bash
# Generate image from prompt
bun scripts/reve.ts create "A beautiful sunset over mountains" -o sunset.png

# With aspect ratio
bun scripts/reve.ts create "A cat in space" -o cat.png --aspect 16:9

# Edit existing image
bun scripts/reve.ts edit "Add dramatic clouds" -i photo.png -o edited.png

# Remix multiple images
bun scripts/reve.ts remix "Person from <img>0</img> in scene from <img>1</img>" -i person.png -i background.png -o remix.png
```

## Commands

### create
Generate a new image from a text prompt.

Options:
- `-o, --output FILE` — Output file path (default: output.png)
- `--aspect RATIO` — Aspect ratio: 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 1:1 (default: 3:2)
- `--version VER` — Model version (default: latest)

### edit
Modify an existing image using text instructions.

Options:
- `-i, --input FILE` — Input image to edit (required)
- `-o, --output FILE` — Output file path (default: output.png)
- `--version VER` — Model version: latest, latest-fast, reve-edit@20250915, reve-edit-fast@20251030

### remix
Combine text prompts with reference images. Use `<img>N</img>` in prompt to reference images by index (0-based).

Options:
- `-i, --input FILE` — Reference images (can specify multiple, up to 6)
- `-o, --output FILE` — Output file path (default: output.png)
- `--aspect RATIO` — Aspect ratio (same options as create)
- `--version VER` — Model version: latest, latest-fast, reve-remix@20250915, reve-remix-fast@20251030

## Constraints

- Max prompt length: 2560 characters
- Max reference images for remix: 6
- Valid aspect ratios: 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 1:1

## Response

The script outputs JSON with generation details:
```json
{
  "output": "path/to/output.png",
  "version": "reve-create@20250915",
  "credits_used": 18,
  "credits_remaining": 982
}
```

## Errors

- `401` — Invalid API key
- `402` — Insufficient credits
- `429` — Rate limited (includes retry_after)
- `422` — Invalid input (prompt too long, bad aspect ratio)