Skip to main content
Back to API Platform

Riverflow API

Sourceful Riverflow 2.0 (Fast + Pro) via Runware. Text-to-image with optional reference image guidance — references steer style and composition, the model generates a fresh frame from your prompt. Two quality tiers. Integrate this model via REST with endpoint docs, parameters, and code examples.

Image Generation
Credit Cost
1 credit
Type
Image

API Endpoint

POST
/api/v1/models/riverflow/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

Parameters

Input parameters accepted by this model

ParameterTypeDefault
prompt
required
string
-
model
enum
fast
aspect_ratio
enum
1:1
resolution
enum
2k
num_outputs
integer
1
reference_images
string
-
seed
integer
-

Supported Aspect Ratios

1:1
4:3
3:4
16:9
9:16
3:2
2:3
5:4
4:5
7:3

Example Outputs

Real outputs generated by this model

a serene mountain lake at sunrise, mirror reflection, soft pastel sky
View Details

a serene mountain lake at sunrise, mirror reflection, soft pastel sky

1 credit
78.8s
a cozy bookstore cafe interior, warm lighting, hanging plants, wooden shelves
View Details

a cozy bookstore cafe interior, warm lighting, hanging plants, wooden shelves

1 credit
42.8s
a peaceful zen rock garden with raked sand and smooth stones, soft morning light
View Details

a peaceful zen rock garden with raked sand and smooth stones, soft morning light

1 credit
53.5s
a butterfly resting on a blooming sunflower, vivid macro photography
View Details

a butterfly resting on a blooming sunflower, vivid macro photography

1 credit
40.0s
a classic sports car parked on a scenic coastal mountain road at sunset
View Details

a classic sports car parked on a scenic coastal mountain road at sunset

1 credit
35.3s
a colorful farmers market stall overflowing with fresh fruit and vegetables
View Details

a colorful farmers market stall overflowing with fresh fruit and vegetables

1 credit
48.8s
a starry night sky and the milky way over rolling desert sand dunes
View Details

a starry night sky and the milky way over rolling desert sand dunes

1 credit
41.6s
a delicate bonsai tree on a minimalist desk under soft studio lighting
View Details

a delicate bonsai tree on a minimalist desk under soft studio lighting

1 credit
39.8s
a charming European cobblestone street with cafe tables and flower boxes
View Details

a charming European cobblestone street with cafe tables and flower boxes

1 credit
41.7s
a misty pine forest with golden sun rays breaking through the tall trees
View Details

a misty pine forest with golden sun rays breaking through the tall trees

1 credit
42.8s
a vibrant coral reef teeming with tropical fish, crisp underwater photography
View Details

a vibrant coral reef teeming with tropical fish, crisp underwater photography

1 credit
41.8s
a lighthouse on a rugged rocky coast during a dramatic orange sunset
View Details

a lighthouse on a rugged rocky coast during a dramatic orange sunset

1 credit
39.9s
a cup of coffee with delicate latte art on a rustic wooden table, morning light
View Details

a cup of coffee with delicate latte art on a rustic wooden table, morning light

1 credit
39.7s
a tropical beach with turquoise water and leaning palm trees, aerial view
View Details

a tropical beach with turquoise water and leaning palm trees, aerial view

1 credit
42.8s
a golden retriever puppy playing in a sunlit summer meadow
View Details

a golden retriever puppy playing in a sunlit summer meadow

1 credit
46.2s
a cozy log cabin in a snowy pine forest, warm light glowing in the windows at night
View Details

a cozy log cabin in a snowy pine forest, warm light glowing in the windows at night

1 credit
42.3s
a hot air balloon festival at dawn, colorful balloons drifting over a green valley
View Details

a hot air balloon festival at dawn, colorful balloons drifting over a green valley

1 credit
42.3s
a tranquil Japanese garden with a koi pond and stone lanterns in autumn
View Details

a tranquil Japanese garden with a koi pond and stone lanterns in autumn

1 credit
43.0s
an astronaut floating above earth among the stars, cinematic, highly detailed
View Details

an astronaut floating above earth among the stars, cinematic, highly detailed

1 credit
42.9s
a vintage red bicycle leaning against a pastel blue wall, flowers in the basket
View Details

a vintage red bicycle leaning against a pastel blue wall, flowers in the basket

1 credit
42.8s
a steaming bowl of ramen with soft-boiled egg, detailed food photography
View Details

a steaming bowl of ramen with soft-boiled egg, detailed food photography

1 credit
42.6s
a field of lavender under a dramatic cloudy sky, rolling hills to the horizon
View Details

a field of lavender under a dramatic cloudy sky, rolling hills to the horizon

1 credit
41.9s
a futuristic city skyline at dusk, neon reflections on wet streets
View Details

a futuristic city skyline at dusk, neon reflections on wet streets

1 credit
39.2s
a majestic snow leopard resting on a rocky cliff at golden hour
View Details

a majestic snow leopard resting on a rocky cliff at golden hour

1 credit
42.5s
a cozy bookstore cafe interior, warm lighting, hanging plants, wooden shelves
View Details

a cozy bookstore cafe interior, warm lighting, hanging plants, wooden shelves

1 credit
42.5s
a serene mountain lake at sunrise, mirror reflection, soft pastel sky
View Details

a serene mountain lake at sunrise, mirror reflection, soft pastel sky

1 credit
35.7s

Code Examples

Fast text-to-image (1 credit) — copy and paste to get started

bash
curl -X POST "https://pixeldojo.ai/api/v1/models/riverflow/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a hand-painted poster of a Tokyo back alley at dusk",
    "model": "fast",
    "aspect_ratio": "3:2",
    "resolution": "2k"
  }'

Response Format

Submit Response (202 Accepted)

json
{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 1,
  "creditsRemaining": 95,
  "expiresAt": "2026-07-18T05:14:35Z"
}

Completed Response

json
{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 1,
  "expiresAt": "2026-07-18T05:14:35Z"
}