Sourceful: Riverflow V2.5 Fast
Riverflow 2.5 Fast ist Sourcefuls Fast-Profil zur Generierung und Bearbeitung von Produkt- und Marketingbildern. Nutzen Sie es, um Kompositionen und gezielte Bearbeitungen innerhalb des von Überlegungen geleiteten Familienablaufs zu erkunden, mit klaren Referenzen, Typografie und Prüfkriterien.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Riverflow 2.5 Fast ist das Fast-Profil von Sourcefuls Riverflow-2.5-Familie zur Bildgenerierung und -bearbeitung. Es eignet sich für frühe kreative Iterationen und wiederholbare Anwendungsschritte, bei denen das Briefing zügig einen brauchbaren Bildkandidaten benötigt. Die Familie kombiniert eine schriftliche Anweisung und Ausgangsbilder mit einem von Überlegungen geleiteten Bearbeitungsprozess, der Kandidaten prüft und korrigiert. Pro ist das separate qualitätsorientierte Profil derselben Generation.
Definieren Sie zur Erkundung pro Briefing eine visuelle Frage: die Umgebung, die Komposition, die Produktanordnung oder eine gezielte Änderung an einem vorhandenen Bild. Eine ursprüngliche Produktreferenz sollte der Bezugspunkt bleiben, während Umgebung oder Beschnitt darum herum wechseln. Eine nützliche Katalogaufgabe kann eine Tischszene für eine Flasche erkunden und dann vergleichen, ob das Bild genug Platz für die freigegebene Überschrift lässt. Halten Sie Produktidentität und vorgesehene Platzierung über Kandidaten hinweg konstant, damit der Vergleich die kreative Entscheidung und nicht einen versehentlichen Motivwechsel betrifft.
Mit der benutzerdefinierten Bewertung der 2.5-Familie lässt sich in einem Bewertungsraster festlegen, was einen Kandidaten brauchbar macht. Geben Sie Kriterien wie erkennbare Verpackung, lesbare Schrift, stimmige Beleuchtung und einen praktikablen Beschnitt vor. Trennen Sie dieses Raster von der Generierungsanweisung: Die eine beschreibt das zu erstellende Bild, das andere bestimmt den Blickwinkel für seine Prüfung. Eine geringere Denkanstrengung ist in der frühen Erkundungsphase nützlich; zusätzliche Prüfung kann danach gezielt den Kriterien gelten, die der erste Kandidat verfehlt hat.
Die Vorbereitung der Referenzen ist für eine gezielte Bearbeitung entscheidend. Bestimmen Sie, welches Bild das Produkt liefert und welches eine Umgebung, Grafik oder Stimmung vorgibt. Benennen Sie das zu ändernde Element und die zu erhaltenden Eigenschaften, etwa eine Deckelform, Etikettenfarbe oder einen lesbaren Produktnamen. Halten Sie bei einer Serie verwandter Varianten Lichtrichtung und Stilbeschreibung konstant und ändern Sie jeweils die eine Eigenschaft, die das Bild unterscheidet. Das Kontextverständnis der Familie unterstützt Produkt- und Kampagnenbilder; das Briefing sollte dennoch die Tatsachen und Referenzen liefern, die den Gegenstand identifizieren.
Font Control kann im 2.5-Ablauf bis zu zwei mitgelieferte benutzerdefinierte Schriftdateien nutzen. Geben Sie die genaue Überschrift und Bildunterschrift, ihre Position und die Schriftrolle jeder Datei an. Eine kleine Anzahl klar definierter Textblöcke macht die Hierarchie leichter beurteilbar als eine dichte Bildfläche mit mehreren widersprüchlichen Vorgaben. Prüfen Sie Schreibweise, Zahlen, Zeilenumbrüche und Schriftstärke im resultierenden Bild in seiner vorgesehenen Nutzungsgrösse. Das Bild ist ein gerendertes Artefakt und keine bearbeitbare Satzdatei oder funktionierende Benutzeroberfläche.
Die Familie enthält Abläufe für normale, einfarbige und transparente Hintergründe. Bereiten Sie ein transparent freigestelltes Motiv vor, wenn das Bild in ein anderes Layout eingebaut werden soll, oder einen kontrollierten einfarbigen Hintergrund, wenn eine Produktserie eine gemeinsame visuelle Basis braucht. Nutzen Sie für ein Kampagnenbild eine ausgearbeitete Szene. Wählen Sie verfügbare Auflösung und Beschnitt passend zur tatsächlichen Ausgabeplatzierung und prüfen Sie danach sichtbare Produkt- und Textdetails, statt anzunehmen, eine grössere Bildfläche allein belege ihre Genauigkeit.
Fast ist von Pro und von der Generation 2.0 getrennt. Riverflow 2.5 ergänzt den früheren mehrstufigen Ansatz um tiefergehende Überlegungen, eigene Prüfkriterien und verbesserte Schrift- und Hintergrundeinstellungen. Behalten Sie für eine nützliche Iterationsschleife den zur Komposition passenden Kandidaten bei, benennen Sie das genaue verbleibende Problem und überarbeiten Sie diesen Teil des Briefings oder Bewertungsrasters. Bewahren Sie das ausgewählte Bild, Ausgangsreferenzen und Prüfkriterien zusammen auf, damit spätere Änderungen dasselbe Motiv weiterentwickeln, statt seine Identität neu zu beginnen.
Ailoot Ultra · Bilder POST /v1/images/generations sourceful/riverflow-v2.5-fast
sourceful/riverflow-v2.5-fastEinstieg
Riverflow 2.5 Fast ist Sourcefuls Fast-Profil zur Generierung und Bearbeitung von Produkt- und Marketingbildern. Nutzen Sie es, um Kompositionen und gezielte Bearbeitungen innerhalb des von Überlegungen geleiteten Familienablaufs zu erkunden, mit klaren Referenzen, Typografie und Prüfkriterien.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Bilder POST /v1/images/generations
- Eingabe
text,image- Ausgabe
image
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits sourceful/riverflow-v2.5-fast | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 1K, 2K | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Standard— |
Feldoutput_format | Typstring | AnforderungOptional | Werte und Limits jpeg | Standard— |
Feldbackground | Typstring | AnforderungOptional | Werte und Limits auto, transparent, opaque | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 1 | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 4 | Standard— |
Feldprovider | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parametermaterial_types | Vertragtext, image |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungseinheit | Gebühr |
|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationAusgabebild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Ausgabebild | Gebühr Ausgabe · Ausgabebild · Schätzung nur zum Vergleich $0.038 pro Ausgabebild |
| KonfigurationGeschätzte Erzeugungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.038 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Bilder
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-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
Ergebnisse abrufen und speichern
Ailoot Ultra · Bilder
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Abrufe anderer Inhalte
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 fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Die zurückgegebene X-Client-Request-ID zum Abgleich aufbewahren. Nur tatsächlich zurückgegebene task_id-/asset_id-Werte oder die eigene Medienbibliothek abfragen; niemals eine Aufgaben-URL aus der Vorgangs-ID bilden und die Erstellung niemals erneut anfordern.
Antwortfelder
| Feld | Typ |
|---|---|
Feldcreated | Typ |
Felddata[].url | Typ |
Felddata[].b64_json | Typ |
Feldusage | Typ |
Aliasnamen
Modellaliasnamen
Ailoot Ultra sourceful/riverflow-v2.5-fast
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · Sourceful: Riverflow V2.5 Fast
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·sourceful/riverflow-v2.5-fast:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·sourceful/riverflow-v2.5-fast:model,prompt,resolution,aspect_ratio,output_format,background,n,input_references,provider- Welche Grenzen gelten?
POST /v1/images/generations·sourceful/riverflow-v2.5-fast:n.minimum:1;n.maximum:1