Sourceful's fast and cost-efficient image editing model optimized for speed and accessibility, delivering performance close to Riverflow 1 across most editing tasks
Example outputs coming soon
Details
riverflow-1-mini
Starting from
Prices shown are in USD
Full pricing detailsProviders & Pricing (1)
Riverflow 1 Mini is available exclusively through Runware, starting at $0.032/image.
runware/riverflow-1-mini
Riverflow 1 Mini API OpenAI-compatible
Integrate Riverflow 1 Mini into your workflow using the Lumenfall OpenAI-compatible API to programmatically generate and edit high-quality images with minimal latency.
https://api.lumenfall.ai/openai/v1
riverflow-1-mini
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-1-mini" \ -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-1-mini', 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 OpenAIclient = OpenAI( api_key="YOUR_API_KEY", base_url="https://api.lumenfall.ai/openai/v1")response = client.images.edit( model="riverflow-1-mini", 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 1 imagesRiverflow 1 Mini FAQ
How much does Riverflow 1 Mini cost?
Riverflow 1 Mini starts at $0.032 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.
How do I use Riverflow 1 Mini via API?
You can use Riverflow 1 Mini through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "riverflow-1-mini". Code examples are available in Python, JavaScript, and cURL.
Which providers offer Riverflow 1 Mini?
Riverflow 1 Mini is available through Runware on Lumenfall. Lumenfall automatically routes requests to the best available provider.
What is the maximum resolution for Riverflow 1 Mini?
Riverflow 1 Mini supports images up to 1024x1024 resolution.
Overview
Riverflow 1 Mini is a lightweight, high-speed image editing model developed by Sourceful. Designed as a streamlined version of the full Riverflow 1 architecture, it focuses on delivering low-latency text-to-image and image-to-image modifications without the computational overhead of larger diffusion models. It bridges the gap between efficiency and quality, maintaining high fidelity across common editing operations while significantly reducing inference costs.
Strengths
- Inference Speed: Optimized for near-instantaneous processing, making it suitable for real-time applications and iterative design workflows where rapid feedback is required.
- Instruction Following: High accuracy in mapping natural language descriptions to visual changes, particularly for localized edits such as object insertion or color modification.
- Resource Efficiency: Occupies a smaller memory footprint than its flagship counterpart, allowing for high-throughput scaling at a lower price point ($0.032 starting price).
- Visual Consistency: Effectively retains the semantic structure and composition of the original input image during the editing process, minimizing unwanted global artifacts.
Limitations
- Complex Composition: May struggle with intricate multi-subject scenes or highly specific spatial relationships compared to the full-scale Riverflow 1 model.
- Fine Detail Grains: While effective for most tasks, the “Mini” architecture may exhibit slightly less texture sharpness or finer detail resolution in extremely high-resolution outputs.
- Extreme Stylization: Large-scale stylistic overhauls that require deep structural reimagining may result in less coherent outputs than larger, more parameter-heavy models.
Technical Background
Riverflow 1 Mini belongs to the Riverflow family of generative models, utilizing a specialized architecture optimized for image-to-image transformations. It leverages a distilled training approach where the model learns to approximate the performance of larger teacher models while operating on a reduced parameter count. This architectural choice prioritizes throughput and accessibility, specifically targeting the Runware infrastructure for optimized hardware utilization.
Best For
Riverflow 1 Mini is ideal for developers building consumer-facing photo editing tools, e-commerce assets, or social media content generators that require high volume and low costs. It excels in tasks like background replacement, object recoloring, and simple guided text-to-image generation. This model is available directly through Lumenfall’s unified API and playground, allowing for seamless integration into existing image processing pipelines alongside other leading generative models.
Try Riverflow 1 Mini in Playground
Generate images with custom prompts — no API key needed.