Source: https://ailoot.ai/models/en/sourceful-riverflow-v2-fast/
Canonical: https://ailoot.ai/models/en/sourceful-riverflow-v2-fast/
Language: en

# Sourceful: Riverflow V2 Fast

[Markdown](https://ailoot.ai/models/en/sourceful-riverflow-v2-fast/index.md) · [JSON](https://ailoot.ai/models/en/sourceful-riverflow-v2-fast/facts.json)

## [Sourceful: Riverflow V2 Fast](https://ailoot.ai/models/en/sourceful-riverflow-v2-fast/)

Riverflow 2.0 Fast is Sourceful’s Fast profile for image creation and focused visual edits. Use clear product and style references to explore marketing imagery within a multi-step workflow that reviews candidates and preserves typography and detail.

- [**Ailoot Ultra · Images** `POST /v1/images/generations` `sourceful/riverflow-v2-fast`](https://ailoot.ai/models/en/sourceful-riverflow-v2-fast/#method-0)

About the model

This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.

Riverflow 2.0 Fast is the Fast profile of Sourceful’s Riverflow 2.0 image generation and editing family. It is useful for exploring a visual direction or carrying out a clearly specified edit before refining the selected creative. The family adds reasoning-led candidate review and correction to image generation, with attention to brand typography and product detail. Pro is the separate profile for quality-sensitive work within the same generation.

Prepare a focused brief with the subject, setting, lighting and one visual change to explore. A practical early-stage task can place a product pouch on a kitchen surface, leaving a defined area for a headline. Supply the reference that establishes the pouch shape, colour and label, then describe the environment rather than asking for an entirely unspecified advertisement. Keep important product features fixed when comparing different settings or crops.

For editing, state the requested change directly and identify the surrounding details that should stay intact. Replacing a background, adjusting the composition or changing a supporting prop should not make the main product a new SKU. The 2.0 family reviews candidates and makes corrections over multiple steps, so the brief needs a concrete target rather than a general request for a nicer image. Retain the source image when inspecting whether the change preserved the object and its visible wording.

The family’s font-control workflow supports public or supplied custom fonts, with up to two fonts and 300 characters per image in the 2.0 release. Give the exact words and the typographic role of each block. A headline and a small caption can define a useful hierarchy without making the whole canvas a dense document. Check spelling, numbers, spacing and small lettering at the intended display size. A rendered caption is visual content, not a replacement for an editable design file.

For detail problems that remain in a generated scene, the separate 2.0 reference-based super-resolution workflow can use high-quality artwork to repair product text and label details. The release describes up to four replacement instances, whether on one product or across several in the composition. Preserve the original artwork so a repair is guided by the actual design. This is a later detail-preservation stage around the image, not an instruction to assume that every first candidate is already exact.

A useful asset set keeps lighting, visual style and product references consistent while varying the intended scene or placement. For a catalogue, record the image’s product reference and brief alongside the selected output. For a campaign, compare whether the crop leaves room for approved copy and whether the product remains recognisable. Choose which candidate to refine based on the actual task instead of losing the original requirements as the visual direction develops.

Fast remains distinct from Pro and from Riverflow 2.5’s newer custom-judging controls. A focused follow-up can correct a label, remove a supporting object or adjust the arrangement while retaining the successful parts of the scene. The useful deliverable is a selected image connected to its source and intended placement, with later typographic or detail repair guided by the original artwork and the specific detail that needs correction.

**Ailoot Ultra · Images** `POST /v1/images/generations` `sourceful/riverflow-v2-fast`

[`sourceful/riverflow-v2-fast`](https://ailoot.ai/models/en/#m=sourceful%2Friverflow-v2-fast&route=Ultra&caller=sourceful%2Friverflow-v2-fast&fmt=images)

Sourceful /`sourceful/riverflow-v2-fast`

### Overview

Riverflow 2.0 Fast is Sourceful’s Fast profile for image creation and focused visual edits. Use clear product and style references to explore marketing imagery within a multi-step workflow that reviews candidates and preserves typography and detail.

Accepted inputs

Text · Images

Results

Images

### Available in Ailoot · inputs & methods

**Ailoot Ultra · Images** `POST /v1/images/generations`

Input types

`text`, `image`

Output types

`image`

| Field | Type | Requirement | Values & limits | Default |
| --- | --- | --- | --- | --- |
| Field`model` | Type`string` | RequirementRequired | Values & limits sourceful/riverflow-v2-fast | Default— |
| Field`prompt` | Type`string` | RequirementRequired | Values & limits Minimum length: 1 | Default— |
| Field`resolution` | Type`string` | RequirementOptional | Values & limits 1K, 2K, 4K | Default— |
| Field`aspect_ratio` | Type`string` | RequirementOptional | Values & limits 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Default— |
| Field`n` | Type`integer` | RequirementOptional | Values & limits Minimum: 1 Maximum: 1 | Default— |
| Field`input_references` | Type`array` | RequirementOptional | Values & limits Minimum items: 0 Maximum items: 4 | Default— |
| Field`provider` | Type`object` | RequirementOptional | Values & limits | Default— |

Method parameters and lifecycle

| Parameter | Contract |
| --- | --- |
| Parameter`content_type` | Contractapplication/json |
| Parameter`required` | Contractmodel, prompt |
| Parameter`material_types` | Contracttext, image |

Lifecycle: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · actual returned task\_id or media library record

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### Pricing

##### How the final charge is calculated

The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.

Tariff references do not add request options. Supported parameters are listed for the selected method.

Fast mode

Not specified When fast mode is selected

Flex mode

Not specified When flex mode is selected

Maximum reasoning effort

Not specified When maximum reasoning effort uses the default adjustment

#### Estimated rates for comparison

#### Prices by configuration

Match each charge to the conditions shown. Use one rate for each set of alternative configurations.

| Configuration | Rate schedule | Forecast quantity | Billing unit | Charge |
| --- | --- | --- | --- | --- |
| ConfigurationBase token rates | Rate scheduleBase rate | Forecast quantity— | Billing unit— | Charge Input · Input tokens · Estimate for comparison only **—** / 1K tokens Output · Output tokens · Estimate for comparison only **—** / 1K tokens Input · Cache read · Estimate for comparison only **—** / 1K tokens Input · Cache write · Estimate for comparison only **—** / 1K tokens Input · Cache write, 1 hour · Estimate for comparison only **—** / 1K tokens |
| ConfigurationFont input | Rate schedule— | Forecast quantity— | Billing unitper image | Charge Input · Font input · Estimate for comparison only **$0.06** per image |
| ConfigurationInput reference | Rate schedule— | Forecast quantity— | Billing unitper image | Charge Input · Input reference · Estimate for comparison only **$0.4** per image |
| Configurationoutput image | Rate schedule— | Forecast quantity— | Billing unitper output image | Charge Output · output image · Estimate for comparison only **$0.04** per output image |
| ConfigurationEstimated generation cost | Rate schedule— | Forecast quantityone generation estimate | Billing unit— | Charge Output · Estimated generation cost · Estimate for comparison only **$0.04** estimate before generation This estimate is not an additional charge or a fixed rate for the completed generation. |

Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. [How reservation and settlement work →](https://ailoot.ai/docs/en/billing/reserve/)

### Example requests

#### Ailoot Ultra · Images

curl

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'sourceful/riverflow-v2-fast', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
```

### Receive and save results

#### Ailoot Ultra · Images

Download each returned image or save its Base64 contents

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

Other content reads

Read existing owned assets

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
```

##### Keep all completed results

Save every completed image; retrieve each returned URL or decode its Base64 contents.

Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.

##### If the original response needs checking

Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task\_id/asset\_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation.

Response fields

| Field | Type |
| --- | --- |
| Field`created` | Type |
| Field`data[].url` | Type |
| Field`data[].b64_json` | Type |
| Field`usage` | Type |

### Aliases

#### Model aliases

**Ailoot Ultra** [`sourceful/riverflow-v2-fast`](https://ailoot.ai/models/en/#m=sourceful%2Friverflow-v2-fast&route=Ultra&caller=sourceful%2Friverflow-v2-fast&fmt=images)

#### Method path aliases

`/v1/images`

#### Related caller IDs

[`sourceful/riverflow-v2-fast`](https://ailoot.ai/models/en/#m=sourceful%2Friverflow-v2-fast&route=Ultra&caller=sourceful%2Friverflow-v2-fast&fmt=images)

FAQ · Sourceful: Riverflow V2 Fast

What inputs and results are available?

`POST /v1/images/generations` · `sourceful/riverflow-v2-fast`: `text`, `image` → `image`

Which fields does the request use?

`POST /v1/images/generations` · `sourceful/riverflow-v2-fast`: `model`, `prompt`, `resolution`, `aspect_ratio`, `n`, `input_references`, `provider`

What limits apply?

`POST /v1/images/generations` · `sourceful/riverflow-v2-fast`: `n.minimum`: `1`; `n.maximum`: `1`

Connect Ailoot to Claude Code, OpenCode, Hermes or your own app.

## The company and its project portfolio

The company and its project portfolio: millions of customers; monthly sales in the billions.

## Buy tokens at a discount.

Subscription discounts for regular use. Promo codes offer up to 50% off token purchases.

Subscription

Choose a discounted plan for your regular requests.

Promo code: up to 50% off

Enter your code at checkout. The price updates to reflect the current promotion.

Spending in your history

The model, tokens and amount are recorded for each request.

[Choose a subscription](https://ailoot.ai/docs/en/billing/subscriptions/) · [View model prices](https://ailoot.ai/models/en/)

## Connect the API to a product you sell.

Use Ailoot in SaaS, apps and bots under its official service offer and licence agreement. Request a reseller licence for resale.

Commercial application

Add text, image, video and audio generation to paid features in your service.

Reseller licence

Send a description of your project and how you provide access. Request written terms for use and resale.

Documents on the website

The service offer, licence agreement and data processing policy are available before you connect.

[Request a reseller licence](mailto:support@ailoot.ai) · [Service offer and licence agreement](https://ailoot.ai/legal/offer?lang=en)

## Ailoot · The company and its project portfolio





Ailoot combines established operating experience, a large client base, stable service and ongoing KPI control.





The company and its project portfolio: millions of customers; monthly sales in the billions.





Ailoot brings that operating experience to API access for AI features in customer products, agents, applications and automations.
