# Reve Image 1.0

> Reve AI's text-to-image generation model with strong aesthetic quality, accurate text rendering, and detailed instruction following capabilities

## Quick Reference

- Model ID: reve
- Creator: Reve AI
- Status: active
- Family: reve
- Base URL: https://api.lumenfall.ai/openai/v1

## Specifications

- Input Modalities: text, image
- Output Modalities: image
- Supported Modes: Text to Image, Image Edit

## API Parameters

The compiled parameter schema for this model is available via the API: `GET /v1/models/reve?schema=true`.

### Core Parameters

- `prompt` (string) — REQUIRED: Text prompt for image generation. Modes: Text to Image, Image Edit
- `seed` (integer): Random seed for reproducibility. Modes: Text to Image, Image Edit

### Size & Layout

- `size` (string): Image dimensions as WxH pixels (e.g. "1024x1024") or aspect ratio (e.g. "16:9"). Values: 1365x768, 768x1365, 1254x836, 836x1254, 887x1182, 1024x1024, 1183x887. Modes: Text to Image, Image Edit
- `aspect_ratio` (string): Aspect ratio of the output image (e.g. "16:9", "1:1"). Values: 9:16, 2:3, 3:4, 1:1, 4:3, 3:2, 16:9. Modes: Text to Image, Image Edit
- `resolution` (string): Output resolution tier (e.g. "1K", "4K"). Values: 1K. Modes: Text to Image, Image Edit

### Media Inputs

- `image` (file) — REQUIRED: Input image(s) to edit. Modes: Image Edit

### Output & Format

- `response_format` (string): How to return the image. Default: url. Values: url, b64_json. Modes: Text to Image, Image Edit
- `output_format` (string): Output image format. Values: png, jpeg, gif, webp, avif. Modes: Text to Image, Image Edit
- `output_compression` (integer): Compression level for lossy formats (JPEG, WebP, AVIF). Modes: Text to Image, Image Edit
- `n` (integer): Number of images to generate. Default: 1. Modes: Text to Image, Image Edit

### Additional Parameters

- `sync_mode` (boolean): If `True`, the media will be returned as a data URI and the output data won't be available in the request history.. Modes: Text to Image, Image Edit. Only available via fal
- `version` (string): The specific model version to use when generating the image. Values: latest, latest-fast, reve-create@20250915, reve-edit-fast@20251030, reve-edit@20250915. Modes: Text to Image, Image Edit. Only available via replicate


## Model Identifiers

- Primary Slug: reve
- Aliases: reve-image-1


## Tags

image-generation, text-to-image, image-editing, typography

## Available Providers

### Replicate

- Config Key: replicate/reve
- Provider Model ID: reve/create
- Pricing: $0.040/image
  - Note: Text-to-image generation with editing capabilities
  - Note: Preserves spatial relationships and structure
  - Source: https://replicate.com/reve/create

### fal.ai

- Config Key: fal/reve
- Provider Model ID: fal-ai/reve/text-to-image
- Pricing: $0.040/image
  - Source: https://fal.ai/models/fal-ai/reve/text-to-image

### fal.ai

- Config Key: fal/reve-edit
- Provider Model ID: fal-ai/reve/edit
- Pricing: $0.040/image
  - Source: https://fal.ai/models/fal-ai/reve/text-to-image

### Replicate

- Config Key: replicate/reve--edit
- Provider Model ID: reve/edit
- Pricing: $0.040/image
  - Note: Image editing endpoint for the Reve model
  - Source: https://replicate.com/reve/edit


## Performance Metrics

Provider performance over the last 30 days.

### fal

- Median Generation Time (p50): 15400ms
- 95th Percentile Generation Time (p95): 22116ms
- Average Generation Time: 14437ms
- Success Rate: 100.0%
- Total Requests: 12
- Time to First Byte (p50): 18797ms
- Time to First Byte (p95): 19977ms

### replicate

- Median Generation Time (p50): 20184ms
- 95th Percentile Generation Time (p95): 23682ms
- Average Generation Time: 18455ms
- Success Rate: 83.3%
- Total Requests: 12
- Time to First Byte (p50): 19444ms
- Time to First Byte (p95): 25465ms


## Arena Benchmarks

### Night Sky Transformation

- Elo: 1251
- Record: 12W / 11L / 2T (25 battles)
- Rank: #2 of 16

### Studio Ghibli Anime Style

- Elo: 1230
- Record: 19W / 12L / 1T (32 battles)
- Rank: #6 of 14

### Victorian Greenhouse Oasis

- Elo: 1199
- Record: 8W / 16L / 4T (28 battles)
- Rank: #9 of 17

### Bald man challenge

- Elo: 1161
- Record: 7W / 21L / 1T (29 battles)
- Rank: #11 of 15

### Geometric Composition

- Elo: 1159
- Record: 3W / 19L / 3T (25 battles)
- Rank: #19 of 22

### Golden Hour Stroll

- Elo: 1142
- Record: 8W / 25L / 2T (35 battles)
- Rank: #12 of 13

### Fantasy Warrior

- Elo: 1139
- Record: 8W / 12L / 0T (20 battles)
- Rank: #17 of 21

### Isometric Miniature Diorama Scenes

- Elo: 1125
- Record: 3W / 20L / 1T (24 battles)
- Rank: #19 of 21

### Neutral Expression to Genuine Smile

- Elo: 1108
- Record: 2W / 23L / 4T (29 battles)
- Rank: #14 of 14

### Over-the-top cartoon caricature

- Elo: 1099
- Record: 5W / 24L / 1T (30 battles)
- Rank: #13 of 13

### Apollo 11: Journey to Tranquility

- Elo: 1095
- Record: 2W / 20L / 0T (22 battles)
- Rank: #17 of 19

### Fantasy Warrior

- Elo: 990
- Record: 0W / 5L / 3T (8 battles)
- Rank: #13 of 14


## Use Cases & Category Performance

### Anime (Image Editing)

- Rank: #9 of 14
- Elo: 1211
- Record: 18W / 11L / 1T (30 battles)
- Win Rate: 60.0%

### Portrait (Text-to-Image)

- Rank: #14 of 21
- Elo: 1164
- Record: 8W / 12L / 0T (20 battles)
- Win Rate: 40.0%

### Photorealism (Image Editing)

- Rank: #14 of 16
- Elo: 1187
- Record: 29W / 80L / 9T (118 battles)
- Win Rate: 24.6%

### Portrait (Image Editing)

- Rank: #14 of 15
- Elo: 1160
- Record: 9W / 44L / 5T (58 battles)
- Win Rate: 15.5%

### Text Rendering (Text-to-Image)

- Rank: #22 of 23
- Elo: 1107
- Record: 2W / 20L / 0T (22 battles)
- Win Rate: 9.1%


## Image Gallery

17 images available for this model. Browse all at https://lumenfall.ai/models/reve-ai/reve/gallery

### Curated Examples

- [A hyper-realistic cinematic wide shot of a master calligrapher’s studio perched atop a misty Hima...](https://assets.lumenfall.ai/rpp4UKFkK9BP8WNCI0FBbwPeXHACQRaYhtbItrMXhO0/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/1ekyest8jo9f9tvm9bifuc5x8z7r@jpeg)
- [Cinematic wide shot of a sophisticated, high-end boutique storefront at dusk. The warm, golden in...](https://assets.lumenfall.ai/YghLjfAfilmKbXDSJ3xlKb0qBeuegSBun6PVnBsqxBY/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/oovw22znu9r1a5l558b1wlf83bk0@jpeg)
- [A hyper-realistic cinematic close-up of a vintage brass orrery, intricate gears and celestial sph...](https://assets.lumenfall.ai/sW7RQGHo4vpnVErhDr858E_CL68k9-tRWUMZ1Fgema8/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/qmqyu058vpdwziiqas4tgssyb2j2@jpeg)
- [A hyper-realistic cinematic close-up of an elderly craftsman's hands carefully assembling a compl...](https://assets.lumenfall.ai/C7gDP-WnR8GrH-kwa_x0uzmiQHWsuVxbiK9-pJbCOJ8/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/0o7ymcpdmyrwotyd1ikzt0glh9tw@jpeg)
- [A sun-drenched coastal flower shop with a large chalkboard sign out front that says "FRESH BLOOMS...](https://assets.lumenfall.ai/iKXOsvUYeo7Fi2xmXODqAZE0ICkSycPRDxMJzvI7igg/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/90uw40at7r902o3o2rfzr1k0jvvv@jpeg)

### Arena Competition Results

- [Night Sky Transformation](https://assets.lumenfall.ai/yxyzxG8Sp83yfC0q8T9BvPkoFbLOCkEPyh9cWER3uw8/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/4g3eu9n8pe2912zukfzwdcrm9s49@jpeg): #2 of 16 (Elo 1251)
- [Studio Ghibli Anime Style](https://assets.lumenfall.ai/ImPi5NNUxNKHPt-sDhrTWAMl859ueCtqENvFPYRRRdk/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/5tt6nrm6uqo6lpbcs83pnkyia07d@jpeg): #6 of 14 (Elo 1230)
- [Victorian Greenhouse Oasis](https://assets.lumenfall.ai/1qw-2Hbcn79kwPbE4Nw90nzx2ErqQduWCRTPkqruexs/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/00n852qxjoiuq81ke3mjmjkuvay5@jpeg): #9 of 17 (Elo 1199)
- [Bald man challenge](https://assets.lumenfall.ai/bljVB5rdF-fWWm5ly4g2CbtYJrYDUx_fQjVIbfmeR88/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/0mmhdy72zfl888utw2n6nrx5mzk1@jpeg): #11 of 15 (Elo 1161)
- [Geometric Composition](https://assets.lumenfall.ai/yEOE3nCICq1aOPr5neOgIEEc6Dg3DQH8WBNZZq01KEI/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/tj77sk4od6b9qwijhmc7t7wgx2g1@jpeg): #19 of 22 (Elo 1159)
- [Golden Hour Stroll](https://assets.lumenfall.ai/M1fGp172LZaF41jTwYxysHoYvDPHjKlrELpyRS36ozo/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/nm17tb32jl7xdhj3yaca6k459f1n@jpeg): #12 of 13 (Elo 1142)
- [Fantasy Warrior](https://assets.lumenfall.ai/0NAiGd1xTSzzr3L0KAlUKmSeaQOvWCSbUG9UwTy_P_Q/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/4gzif4x809gng99549bpq4aesbru@jpeg): #17 of 21 (Elo 1139)
- [Isometric Miniature Diorama Scenes](https://assets.lumenfall.ai/S0EpxRlcuiIVYTcXhYGI8-ZxZKC1zXTzV4obWPOitJU/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/dl5o1a3v2tyj9al5rciiny3qmy1i@jpeg): #19 of 21 (Elo 1125)
- [Neutral Expression to Genuine Smile](https://assets.lumenfall.ai/UduzwVIqMVA1W0IYy1BxSeR-0aSWgWhVFrA-Y1jzi_Q/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/lsrftlruj3oxtnz9th0hjj2u9uru@jpeg): #14 of 14 (Elo 1108)
- [Over-the-top cartoon caricature](https://assets.lumenfall.ai/mGvjx6Cs0X5wlhIYYBga1SehHhqc_EB_0nVNlqOuRfs/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/c71mj7qyoc3emctccvlui56ye0ev@jpeg): #13 of 13 (Elo 1099)
- [Apollo 11: Journey to Tranquility](https://assets.lumenfall.ai/y0AaQ5GbCzsyFsMEAKTetF0UqsemfXx7yE-6o2Ulgfs/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/ku2nhgvgi7i8vvko61cduxc0b6mp@jpeg): #17 of 19 (Elo 1095)
- [Fantasy Warrior](https://assets.lumenfall.ai/ORQNjAMB2T1sKPg6dsEgMIMp8mMGRWw6SrirhRAin-8/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/lubdconotsdzzp1sdw1rown3zoc2@jpeg): #13 of 14 (Elo 990)

## Example Prompt

The following prompt was used to generate an example image in our playground:

A sun-drenched coastal flower shop with a large chalkboard sign out front that says "FRESH BLOOMS & WILD PEONIES" in elegant cursive. A calm capybara is resting peacefully on the cool tiles by the door, partially hidden by a bucket of lilies.

## Code Examples

### Text to Image (/v1/images/generations)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "reve",
    "prompt": "",
    "size": "1024x1024"
  }'

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.generate({
  model: 'reve',
  prompt: '',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.generate(
    model="reve",
    prompt="",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)

### Image Edit (/v1/images/edits)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/edits \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -F "model=reve" \
  -F "image=@source.png" \
  -F "prompt=Add a starry night sky to this image" \
  -F "size=1024x1024"

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.edit({
  model: 'reve',
  image: fs.createReadStream('source.png'),
  prompt: 'Add a starry night sky to this image',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.edit(
    model="reve",
    image=open("source.png", "rb"),
    prompt="Add a starry night sky to this image",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)


## About

## Overview
Reve Image 1.0 is a high-fidelity text-to-image model developed by Reve AI that prioritizes visual aesthetics and precise instruction adherence. Unlike many early-generation diffusion models that struggle with complex prompts, Reve 1.0 is engineered to maintain high compositional integrity and detailed attribute mapping. It is particularly distinctive for its ability to render legible, accurate typography directly within generated images.

## Strengths
*   **Typography and Text Rendering:** The model excels at embedding clear, correctly spelled text into images, making it suitable for graphic design assets, logos, and posters.
*   **Instruction Following:** It demonstrates a high degree of sensitivity to complex, multi-part prompts, accurately placing objects and applying specific colors or textures as described.
*   **Aesthetic Quality:** The model produces outputs with a polished, professional look, showing particular strength in lighting, skin textures, and balanced photographic compositions.
*   **Multimodal Input:** It supports both text-to-image and image-to-image workflows, allowing for fine-grained control over layout and style through reference images.

## Limitations
*   **Computational Cost:** With a starting price around $0.04 per generation, it carries a higher per-image cost than many standard open-weights models or optimized distilled versions.
*   **Anatomical Edge Cases:** While highly capable, it may still produce artifacts in complex human poses or high-density crowd scenes, similar to other models in the current diffusion generation.
*   **Inference Latency:** Given its focus on high-detail output and aesthetic quality, it may have a longer generation time compared to "turbo" or lightning-fast latent consistency models.

## Technical Background
Reve Image 1.0 is a diffusion-based model designed around a large-scale transformer architecture optimized for visual-textual alignment. While specific architectural details are proprietary, its training pipeline emphasizes high-quality captioned datasets to improve the semantic connection between user prompts and pixel generation. The model utilizes advanced sampling techniques to achieve its signature sharpness and textural detail.

## Best For
This model is best suited for professional creative workflows where visual fidelity and typographic accuracy are non-negotiable, such as social media marketing, UI/UX concepting, and digital illustration. It is a strong choice for users who need a "first-shot" generation that requires minimal post-processing or manual image editing to fix text errors. Reve Image 1.0 is available through Lumenfall’s unified API and playground, allowing developers to integrate its high-aesthetic outputs into their own applications alongside other leading generative models.

## Frequently Asked Questions

### How much does Reve Image 1.0 cost?

Reve Image 1.0 starts at $0.04 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.

### How do I use Reve Image 1.0 via API?

You can use Reve Image 1.0 through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "reve". Code examples are available in Python, JavaScript, and cURL.

### Which providers offer Reve Image 1.0?

Reve Image 1.0 is available through Replicate and fal.ai on Lumenfall. Lumenfall automatically routes requests to the best available provider.

## Links

- Model Page: https://lumenfall.ai/models/reve-ai/reve
- About: https://lumenfall.ai/models/reve-ai/reve/about
- Providers, Pricing & Performance: https://lumenfall.ai/models/reve-ai/reve/providers
- API Reference: https://lumenfall.ai/models/reve-ai/reve/api
- Benchmarks: https://lumenfall.ai/models/reve-ai/reve/benchmarks
- Use Cases: https://lumenfall.ai/models/reve-ai/reve/use-cases
- Gallery: https://lumenfall.ai/models/reve-ai/reve/gallery
- Playground: https://lumenfall.ai/playground?model=reve
- API Documentation: https://docs.lumenfall.ai