reve-ai

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

# 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:

{
  "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)