# Riverflow 1 Pro

> Sourceful's highest-quality Riverflow 1 variant for professional image editing workflows with enhanced precision and output quality

## Quick Reference

- Model ID: riverflow-1-pro
- 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-1-pro

## Dates


## Tags

image-generation, image-editing

## Available Providers

### Runware

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


## Image Gallery

1 images available for this model.
- Curated examples: 1
  - "A wide, cinematic low-angle shot of a luxury heritage hotel lobby where a grand, majestic indoor waterfall cascades d..."

## Example Prompt

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

A sun-drenched Mediterranean balcony overlooking a sparkling turquoise coast, featuring vibrant bougainvillea and a rustic wooden breakfast table. In the blurry background garden below, a capybara naps peacefully under a lemon tree. High detail.

## 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-1-pro",
    "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-1-pro',
  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-1-pro",
    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-1-pro" \
  -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-1-pro',
  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-1-pro",
    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 1 Pro is an advanced image-to-image and text-to-image model developed by Sourceful, specifically engineered for high-fidelity professional editing workflows. As the flagship variant in the Riverflow 1 family, it prioritizes output precision and structural integrity over raw generation speed. The model is designed to handle complex manipulations where maintaining the core identity of an input image is as critical as the requested modifications.

## Strengths
*   **High-Fidelity Image Editing:** Excels at "Pro" level transformations, such as changing specific textures or lighting conditions while preserving the geometry and composition of the original source image.
*   **Text Rendering Accuracy:** Demonstrates a high success rate in rendering legible, correctly spelled text within generated images compared to standard diffusion models.
*   **Instruction Adherence:** Closely follows nuanced prompts, allowing for granular control over artistic style, color grading, and object placement without significant "hallucination" or unwanted artifacts.
*   **Structural Consistency:** Maintains physical proportions and spatial relationships during complex re-rendering tasks, making it suitable for architectural visualization or product staging.

## Limitations
*   **Inference Latency:** Due to the complexity and precision of the "Pro" variant, generation times may be longer than those of more lightweight or "Turbo" models in the Riverflow family.
*   **Stylistic Rigidity:** The model’s focus on precision can occasionally result in a more "clinical" or realistic aesthetic, which may require more descriptive prompting to achieve highly abstract or painterly results.

## Technical Background
Riverflow 1 Pro is a latent diffusion model optimized for professional environmental and object manipulation. While it shares a common architecture with the Riverflow series, the Pro variant utilizes a larger parameter count and refined training datasets focused on high-resolution professional photography and design assets. This training approach emphasizes pixel-perfect reconstruction and fine-grained control over global and local image features.

## Best For
Riverflow 1 Pro is ideal for professional design workflows, including product photography post-production, architectural overpainting, and high-quality character consistency tasks. It is an excellent choice for developers building creative tools that require predictable, high-caliber outputs rather than rapid-fire iteration. 

Riverflow 1 Pro is available for immediate testing and deployment through **Lumenfall’s unified API and playground**, providing a streamlined way to integrate professional-grade image generation into your applications.

## Frequently Asked Questions

### How much does Riverflow 1 Pro cost?

Riverflow 1 Pro starts at $0.077 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.

### How do I use Riverflow 1 Pro via API?

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

### Which providers offer Riverflow 1 Pro?

Riverflow 1 Pro is available through Runware on Lumenfall. Lumenfall automatically routes requests to the best available provider.

### What is the maximum resolution for Riverflow 1 Pro?

Riverflow 1 Pro supports images up to 1024x1024 resolution.

## Links

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