Sourceful's balanced Riverflow 2 variant combining realistic output with reliable detail control and smooth integration of reference products for professional image creation
Details
riverflow-2-standard-preview
Ready to integrate?
Access riverflow-2-standard-preview via our unified API.
Starting from
Prices shown are in USD
Full pricing detailsProviders & Pricing (1)
Riverflow 2 Standard Preview is available exclusively through Runware, starting at $0.035/image.
runware/riverflow-2-standard-preview
riverflow-2-standard API OpenAI-compatible
Integrate text-to-image generation and advanced image editing into any application using the Lumenfall OpenAI-compatible API to access Riverflow 2 Standard Preview's professional-grade visual output.
https://api.lumenfall.ai/openai/v1
riverflow-2-standard-preview
Code Examples
Image Edit
/v1/images/editscurl -X POST \
https://api.lumenfall.ai/openai/v1/images/edits \
-H "Authorization: Bearer $LUMENFALL_API_KEY" \
-F "model=riverflow-2-standard-preview" \
-F "[email protected]" \
-F "prompt=Add a starry night sky to this image" \
-F "size=1024x1024"
# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }
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-standard-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);
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-standard-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)
Parameter Reference
Core Parameters
| Parameter | Type | Description | Modes |
|---|---|---|---|
prompt
|
string | Required. Edit instruction for the image |
Edit
|
Size & Layout
| Parameter | Type | Description | Modes |
|---|---|---|---|
size
|
string |
Image dimensions as WxH pixels (e.g. "1024x1024") or aspect ratio (e.g. "16:9")
WxH determines both shape and scale (aspect_ratio and resolution are ignored when size is provided). W:H format is equivalent to aspect_ratio.
|
Edit
|
aspect_ratio
|
string |
Aspect ratio of the output image (e.g. "16:9", "1:1")
Controls shape independently of scale. Use with resolution to control both. If size is also provided, size takes precedence. Any ratio is accepted and mapped to the nearest supported value.
|
Edit
|
resolution
|
string |
Output resolution tier (e.g. "1K", "4K")
Controls scale independently of shape. Higher tiers produce larger images and cost more. If size is also provided, size takes precedence for scale. Any tier is accepted and mapped to the nearest supported value.
|
Edit
|
size
Exact pixel dimensions
"1920x1080"
aspect_ratio
Shape only, default scale
"16:9"
resolution
Scale tier, preserves shape
"1K"
Priority when combined
size is most specific and always wins. aspect_ratio and resolution control shape and scale independently.
How matching works
7:1 on a model with
4:1 and 8:1,
you get 8:1.
0.5K 1K 2K 4K)
or megapixel tiers (0.25 1).
If the exact tier isn't available, you get the nearest one.
Media Inputs
| Parameter | Type | Description | Modes |
|---|---|---|---|
image
|
file |
Required.
Input image(s) to edit
Supports PNG, JPEG, WebP.
|
Edit
|
Output & Format
| Parameter | Type | Description | Modes |
|---|---|---|---|
response_format
|
string |
How to return the image
url
b64_json
Default:
"url" |
Edit
|
output_format
|
string |
Output image format
png
jpeg
gif
webp
avif
Gateway converts to requested format if provider doesn't support it natively.
|
Edit
|
output_compression
|
integer | Compression level for lossy formats (JPEG, WebP, AVIF) |
Edit
|
n
|
integer |
Number of images to generate
Default:
1Gateway generates multiple images in parallel even if provider only supports 1.
|
Edit
|
Parameter Normalization
How we handle parameters across different providers
Not every provider speaks the same language. When you send a parameter, we handle it in one of four ways depending on what the model supports:
| Behavior | What happens | Example |
|---|---|---|
passthrough |
Sent as-is to the provider | style, quality |
renamed |
Same value, mapped to the field name the provider expects | prompt |
converted |
Transformed to the provider's native format | size |
emulated |
Works even if the provider has no concept of it | n, response_format |
Parameters we don't recognize pass straight through to the upstream API, so provider-specific options still work.
Gallery
View all 2 imagesRiverflow 2 Standard Preview FAQ
How much does Riverflow 2 Standard Preview cost?
Riverflow 2 Standard Preview starts at $0.035 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.
How do I use Riverflow 2 Standard Preview via API?
You can use Riverflow 2 Standard Preview through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "riverflow-2-standard-preview". Code examples are available in Python, JavaScript, and cURL.
Which providers offer Riverflow 2 Standard Preview?
Riverflow 2 Standard Preview is available through Runware on Lumenfall. Lumenfall automatically routes requests to the best available provider.
What is the maximum resolution for Riverflow 2 Standard Preview?
Riverflow 2 Standard Preview supports images up to 1024x1024 resolution.
Overview
Riverflow 2 Standard Preview is a generative image model developed by Sourceful, designed to sit at the intersection of photorealistic rendering and precise compositional control. It operates as a multimodal bridge, accepting both text and image inputs to produce high-fidelity visual outputs. This “Standard” variant is specifically tuned to maintain structural integrity while integrating external reference products into generated scenes.
Strengths
- Reference Integration: Excels at “product-in-scene” generation, where a source image of an object is placed into a new environment while maintaining the object’s original proportions and material properties.
- Structural Detail Control: Demonstrates high reliability in following layout constraints provided via image prompts, reducing the “hallucination” of stray limbs or distorted architectural elements.
- Balanced Text-to-Image Alignment: Accurately translates complex atmospheric descriptions (lighting, weather, texture) without sacrificing the sharpness of the primary subjects.
- Photorealistic Texture Rendering: Particularly effective at simulating organic surfaces such as skin, fabric, and wood grain with a neutral, non-stylized finish.
Limitations
- Standard vs. Pro Performance: As the “Standard” variant, it may lack the extreme prompt-adherence granularity found in higher-tier “Pro” versions of the Riverflow family.
- Preview Status: This specific version is a preview release, which means users may encounter occasional inconsistencies in edge-case prompt scenarios that will be refined in the final production release.
- Inference Latency: Due to its focus on structural fidelity and reference integration, it may have slightly longer generation times compared to models optimized solely for speed.
Technical Background
Riverflow 2 belongs to the Riverflow family of diffusion models, utilizing a specialized architecture focused on multimodal input processing. It is engineered to prioritize “detail control,” likely leveraging an enhanced attention mechanism that balances global prompt semantics with localized image reference features. This training approach allows the model to treat reference images as grounding constraints rather than just aesthetic guides.
Best For
This model is best suited for professional product photography mockups, interior design visualization, and e-commerce asset generation where consistency between a physical object and its generated environment is critical. It is also an excellent choice for creators who need to iterate on specific layouts using image-to-image workflows. Riverflow 2 Standard Preview is accessible through Lumenfall’s unified API and interactive playground, allowing developers to test its reference-handling capabilities alongside other industry-standard models.
Try Riverflow 2 Standard Preview in Playground
Generate images with custom prompts — no API key needed.