# Riverflow 2 Max Preview

> Sourceful's most powerful Riverflow 2 variant with maximum thinking time for highest quality unified text-to-image and image editing output

## Quick Reference

- Model ID: riverflow-2-max-preview
- Creator: Sourceful
- Status: active
- Family: riverflow
- Base URL: https://api.lumenfall.ai/openai/v1

## Specifications

- Max Resolution: 1024x1024
- Max Input Images: 3
- Input Modalities: text, image
- Output Modalities: image

## Model Identifiers

- Primary Slug: riverflow-2-max-preview
- Aliases: riverflow-2-max

## Dates


## Tags

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

## Available Providers

### Runware

- Config Key: runware/riverflow-2-max-preview
- Provider Model ID: sourceful:2@3
- Pricing:
  - source: official
  - currency: USD
  - components: [{"type" => "output", "metric" => "image", "unit_price" => 0.075}]
  - source_url: https://runware.ai/pricing
  - effective_at: 2026-01-03


## Image Gallery

2 images available for this model.
- Curated examples: 2
  - "Cinematic wide shot of a high-end, artisan perfume bottle resting on a wet basalt stone amidst a misty, temperate rai..."
  - "A hyper-realistic close-up of an artisan watchmaker's workbench, shallow depth of field, cluttered with intricate bra..."

## Example Prompt

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

A sun-drenched artisan bakery storefront with a large gold-leaf sign on the glass that reads "CRUST & CRUMB" in elegant serif typography. In the background shadows by the flour sacks, a capybara calmly nibbles on a fallen piece of baguette.

## Code Examples

### Text to Image (Generation)

#### 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": "riverflow-2-max-preview",
    "prompt": "A serene mountain landscape at sunset",
    "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: 'riverflow-2-max-preview',
  prompt: 'A serene mountain landscape at sunset',
  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="riverflow-2-max-preview",
    prompt="A serene mountain landscape at sunset",
    size="1024x1024"
)

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

### Image Editing

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/edits \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -F "model=riverflow-2-max-preview" \
  -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: 'riverflow-2-max-preview',
  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="riverflow-2-max-preview",
    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
Riverflow 2 Max Preview is the high-performance variant of Sourceful’s latest diffusion model family, designed for unified text-to-image generation and complex image editing. This version is distinguished by an extended internal processing overhead, referred to by the developers as "maximum thinking time," which prioritizes output fidelity over inference speed. It operates on a unified architecture that allows it to handle both initial generation and modification tasks within a single framework.

## Strengths
*   **Text Rendering Accuracy:** The model demonstrates high precision when integrating legible typography and specific graphical text into generated images, reducing the common artifacting seen in shorter-latency models.
*   **Unified Task Handling:** Unlike models that require separate adapters for editing, Riverflow 2 Max handles text-to-image, image-to-image, and selective editing natively, maintaining stylistic consistency across iterative changes.
*   **Compositional Detail:** The extended processing time allows the model to better resolve complex spatial relationships and crowded scenes described in long-form prompts.
*   **Instruction Following:** It excels at adhering to nuanced modifiers regarding lighting, texture, and camera perspective, making it suitable for professional design workflows where specific artistic control is required.

## Limitations
*   **Inference Latency:** Due to its "maximum thinking time" design, this model has a significantly slower generation speed compared to the standard Riverflow 2 or the "Flash" variants, making it less suitable for real-time applications.
*   **Resource Intensity:** The computational cost per image is higher, as reflected by its starting price point relative to smaller or less intensive diffusion models.
*   **Preview Status:** As a preview release, the model may exhibit occasional inconsistencies in edge cases that are still being refined for the final stable release.

## Technical Background
Riverflow 2 Max is built on a consolidated latent diffusion architecture that treats image generation and editing as a single objective. By increasing the iterative refinement steps—Sourceful’s "thinking time" approach—the model explores a wider search space within the latent manifold before decoding the final image. This provides the transformer-based backbone more cycles to align the visual output with the input tokens and any provided image reference.

## Best For
Riverflow 2 Max Preview is ideal for high-stakes creative production where image quality and prompt adherence are more critical than rapid throughput. It shines in professional graphic design, advertising asset creation, and complex photo manipulation tasks. Users can explore its capabilities and integrate it into their workflows via Lumenfall’s unified API and interactive playground, which provides a streamlined interface for testing its maximum thinking time outputs alongside other models in the Riverflow family.

## Frequently Asked Questions

### How much does Riverflow 2 Max Preview cost?

Riverflow 2 Max Preview starts at $0.075 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.

### How do I use Riverflow 2 Max Preview via API?

You can use Riverflow 2 Max Preview through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "riverflow-2-max-preview". Code examples are available in Python, JavaScript, and cURL.

### Which providers offer Riverflow 2 Max Preview?

Riverflow 2 Max Preview is available through Runware on Lumenfall. Lumenfall automatically routes requests to the best available provider.

### What is the maximum resolution for Riverflow 2 Max Preview?

Riverflow 2 Max Preview supports images up to 1024x1024 resolution.

## Links

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