Sourceful: Riverflow V2.5 Pro
Riverflow 2.5 Pro is het kwaliteitsgerichte profiel van Sourceful voor het genereren en bewerken van product- en campagnebeelden. De familie combineert bewerking in meerdere stappen, beoordeling op maat en lettertypecontrole, zodat een gedetailleerde briefing de merkidentiteit en beoogde opmaak kan behouden.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Riverflow 2.5 Pro is het Pro-profiel van Sourcefuls Riverflow 2.5-familie voor beeldgeneratie en beeldbewerking, gericht op creatief werk waarbij controle en uiteindelijke beeldkwaliteit belangrijk zijn. Een tekstuele opdracht kan een beeld opleveren, terwijl referentieafbeeldingen het product, kunstwerk of de scène aanleveren die moet worden bewerkt. De kenmerkende aanpak van de familie plant meerdere bewerkingsstappen, beoordeelt kandidaten en corrigeert ze in de richting van het gevraagde resultaat, in plaats van het eerste beeld als de volledige workflow te beschouwen.
Bereid voor een campagnebeeld de productreferenties en merkrichting voor voordat je de scène beschrijft. Benoem de productkenmerken die de ene SKU van de andere onderscheiden, de opstelling, belichting en ruimte voor tekst. Een bruikbare opdracht kan drie gelabelde producten in één samenhangende compositie plaatsen en daarbij hun kleuren, afmetingen en zichtbare identiteit onderscheidbaar houden. Geef bij een lifestyle-scène met één product aan welke referentie het voorwerp levert en welke de sfeer of omgeving, en beschrijf vervolgens wat tijdens de transformatie behouden moet blijven.
Riverflow 2.5 voegt een eigen beoordelingsrubriek toe aan het redeneer- en beoordelingsproces. Beschrijf de criteria die belangrijk zijn voor het resultaat: productidentiteit, leesbaarheid van etiketten, compositie, aannemelijkheid van de scène of de hoeveelheid ruimte voor een kop. Na bewerkingsstappen kan het redeneermodel kandidaten aan die rubriek toetsen en bepalen hoe het verdergaat. Een resultaat voor verpakkingen en een expressief campagnebeeld vragen om verschillende beoordelingsprioriteiten; houd daarom de generatie-instructie gescheiden van de criteria waarmee je het resultaat beoordeelt.
De denkinspanning stuurt hoeveel iteratief werk de familie uitvoert en hoe streng zij een beeld beoordeelt voordat het wordt geaccepteerd. De workflow van de ontwikkelaar voor 2.5 loopt van low tot xhigh: een lager niveau ondersteunt vroege verkenning, terwijl meer inspanning nuttig is wanneer de opdracht verdere verfijning vraagt. Meer interne beoordeling vervangt de controle van het voltooide bestand niet. Maak bij een veeleisende productopstelling de belangrijke details en acceptatiecriteria expliciet, zodat extra bewerkingswerk een duidelijk doel heeft.
Font Control accepteert maximaal twee eigen lettertypebestanden en gebruikt de aangeleverde lettervormen, spatiëring en dikte als leidraad. Geef de exacte woorden die moeten worden weergegeven, de rol van elk tekstblok en de bijbehorende lettertypereferentie. Een kop en een korte ondersteunende tekst kunnen verschillende lettertypen gebruiken zonder dat de typografische hiërarchie impliciet blijft. Controleer de daadwerkelijke letters en cijfers in de uitvoer, vooral waar een verpakkingsetiket of productnaam het artikel identificeert, in plaats van een lettertypereferentie als bewijs te zien dat elk teken klopt.
De 2.5-familie biedt normale, effenkleurige en transparante achtergronden als uitvoermodi, waaronder transparante PNG voor compositing, met exportopties op 1K, 2K en maximaal 4K. Kies het resultaat op basis van de toepassing: een vrijstaand object om in een ander ontwerp te verwerken, een gecontroleerde effen achtergrond voor consistente productreeksen of een voltooide scène voor een campagne. Bereid de uitvoervorm en tekstplaatsing samen voor, zodat meer detail in het eindbestand geen oplossing hoeft te bieden voor een compositie waarin het hoofdonderwerp verkeerd staat.
Pro blijft onderscheiden van het Fast-profiel en van de eerdere Riverflow 2.0-generatie. De 2.5-familie bouwt voort op de meerstapsbasis van 2.0, met uitgebreidere beoordelingscontrole, eigen beoordelingscriteria en meer achtergrond- en exportkeuzes. Een nuttige eindcontrole vergelijkt het beeld met de productreferenties, rubriek en typografie en verandert vervolgens de specifieke instructie of het criterium dat een afwijking veroorzaakt. Bewaar het geselecteerde beeld met de opdracht en referenties, zodat de volgende bewerking dezelfde creatieve richting kan verfijnen zonder de opgebouwde identiteit te verliezen.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations sourceful/riverflow-v2.5-pro
sourceful/riverflow-v2.5-proAan de slag
Riverflow 2.5 Pro is het kwaliteitsgerichte profiel van Sourceful voor het genereren en bewerken van product- en campagnebeelden. De familie combineert bewerking in meerdere stappen, beoordeling op maat en lettertypecontrole, zodat een gedetailleerde briefing de merkidentiteit en beoogde opmaak kan behouden.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoertypen
text,image- Uitvoertypen
image
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten sourceful/riverflow-v2.5-pro | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 1K, 2K, 4K | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Standaard— |
Veldoutput_format | Typestring | VereisteOptioneel | Waarden en limieten png, jpeg, webp | Standaard— |
Veldbackground | Typestring | VereisteOptioneel | Waarden en limieten auto, transparent, opaque | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 1 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 10 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| Configuratieuitvoerafbeelding | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper uitvoerafbeelding | Kosten Uitvoer · uitvoerafbeelding · Schatting uitsluitend ter vergelijking $0.26 per uitvoerafbeelding |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.26 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Afbeeldingen
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.5-pro', '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
Resultaten ophalen en opslaan
Ailoot Ultra · Afbeeldingen
Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
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.
Alle voltooide resultaten bewaren
Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra sourceful/riverflow-v2.5-pro
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · Sourceful: Riverflow V2.5 Pro
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·sourceful/riverflow-v2.5-pro:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·sourceful/riverflow-v2.5-pro:model,prompt,resolution,aspect_ratio,output_format,background,n,input_references,provider- Welke limieten gelden?
POST /v1/images/generations·sourceful/riverflow-v2.5-pro:n.minimum:1;n.maximum:1