Sourceful: Riverflow V2 Pro
Riverflow 2.0 Pro je profil Pro spoločnosti Sourceful na tvorbu a úpravu obrázkov pre kreatívu citlivú na identitu značky. Jeho rodina vyhodnocuje a opravuje kandidátov, podporuje vedenie typografie písmami a ponúka opravu detailov produktových etikiet a grafiky podľa referencií.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Riverflow 2.0 Pro je profil Pro z rodiny Riverflow 2.0 spoločnosti Sourceful na tvorbu a úpravu obrázkov pre produktovú, obalovú a marketingovú kreatívu. Spája tvorbu alebo úpravu obrázkov s modelom uvažovania, ktorý vyhodnocuje kandidátov a robí opravy. Jeho určujúcimi prioritami sú spoľahlivé vykonanie vizuálneho zadania, typografia a zachovanie produktových detailov, vďaka ktorým je podklad pre značku užitočný.
Pri kompozícii citlivej na kvalitu dodajte produktový obrázok alebo grafiku, presné znenie a zamýšľané vizuálne rozmiestnenie. Užitočná scéna môže umiestniť nádobu s etiketou vedľa jej ingrediencií a zachovať pritom tvar nádoby a hierarchiu etikety. Opíšte osvetlenie, pozadie a orez a potom uveďte, ktoré detaily produktu sa nemajú zmeniť. Výsledkom je vykreslený kreatívny obrázok; rozhodnutie o jeho začlenení do širšej kampane alebo upraviteľného rozloženia je samostatným krokom aplikácie.
Postup 2.0 automaticky posudzuje kandidátov a opravuje problémy vo viacerých krokoch. Dajte tomuto procesu jasný cieľ oddelením povinného obsahu od voliteľných štýlových rozhodnutí. Pri úprave pomenujte prvok, ktorý sa má zmeniť, aj okolité črty, ktoré sa majú zachovať. Aktualizácia farby produktu sa nemá nepozorovane zmeniť na nový návrh etikety a výmena pozadia má zachovať rozpoznateľnosť dodaného predmetu. Hotový obrázok treba stále porovnať so zadaním a zdrojovými referenciami.
Ovládanie písiem používa verejné alebo dodané vlastné písma na usmernenie typografie značky. Riverflow 2.0 podporuje vo svojom postupe ovládania písiem až dve písma súčasne a najviac 300 znakov na obrázok. Dodajte presný text, hierarchiu a zamýšľanú hrúbku písma či rozostupy a neočakávajte, že model vyberie znenie. Vo výslednom podklade skontrolujte dôležité glyfy, číslice, ligatúry a drobný sprievodný text. Stručné znenie tiež ponecháva priestor na produkt a vizuálne vysvetlenie.
Postup tejto rodiny na zvýšenie rozlíšenia podľa referencií opravuje jemný text alebo grafiku, ktoré scéna s nižším rozlíšením nezachytáva presne. Dodajte kvalitnú zdrojovú grafiku, aby fáza opravy detailov mala skutočnú etiketu alebo návrh na reprodukciu. Vydanie 2.0 opisuje až štyri nahrádzané výskyty na požiadavku, čo umožňuje opravy na jednom produkte alebo na viacerých produktoch v scéne. Ide o postup opravy vygenerovaného obrázka podľa referencie, nie o záruku, že každý prvotný obrázok má dokonalé mikrodetaily.
Pri súvisiacom súbore produktov zachovajte štýl, osvetlenie a štruktúru scény a pre každý predmet dodajte správnu referenciu. Podklad pre kampaň môže kombinovať hlavný pohľad na produkt s praktickým priestorom na schválený text; detailný záber produktu môže uprednostniť detaily etikety a materiálu. Prípravu zdroja a výstupu zvoľte podľa zamýšľanej veľkosti zobrazenia a vybraný obrázok uchovajte s referenciami, ktoré určujú jeho identitu. Korekcia celej scény a krok opravy detailov riešia odlišné časti výstupu.
Pro sa líši od profilu Fast aj od Riverflow 2.5. Neskoršia generácia pridáva vlastné kritériá bodovania a hlbšie ovládanie hodnotenia; tieto novšie nastavenia nemožno automaticky považovať za súčasť profilu 2.0. Pri záverečnej kontrole porovnajte požadovanú zmenu, typografiu, identitu produktu a okolité detaily so zdrojom. Upravte konkrétny pokyn alebo referenciu zodpovednú za nesúlad a zachovajte kompozíciu, ktorá už úlohe vyhovuje.
Ailoot Ultra · Obrázky POST /v1/images/generations sourceful/riverflow-v2-pro
sourceful/riverflow-v2-proÚvod
Riverflow 2.0 Pro je profil Pro spoločnosti Sourceful na tvorbu a úpravu obrázkov pre kreatívu citlivú na identitu značky. Jeho rodina vyhodnocuje a opravuje kandidátov, podporuje vedenie typografie písmami a ponúka opravu detailov produktových etikiet a grafiky podľa referencií.
- Povolené vstupy
- Text · Obrázky
- Výsledky
- Obrázky
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Obrázky POST /v1/images/generations
- Vstup
text,image- Výstup
image
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity sourceful/riverflow-v2-pro | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Poleresolution | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1K, 2K, 4K | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 1 | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 10 | Predvolené— |
Poleprovider | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parametermaterial_types | Špecifikáciatext, image |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Účtovacia jednotka | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacia jednotka— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaVstup písma | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza obrázok | Poplatok Vstup · Vstup písma · Odhad iba na porovnanie $0.06 za obrázok |
| KonfiguráciaVstupná referencia | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza obrázok | Poplatok Vstup · Vstupná referencia · Odhad iba na porovnanie $0.4 za obrázok |
| Konfiguráciavýstupný obrázok | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza výstupný obrázok | Poplatok Výstup · výstupný obrázok · Odhad iba na porovnanie $0.3 za výstupný obrázok |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacia jednotka— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.3 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
Ailoot Ultra · Obrázky
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-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
Prijať a uložiť výsledky
Ailoot Ultra · Obrázky
Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Čítanie ďalšieho obsahu
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.
Uchovať všetky dokončené výsledky
Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.
Ak treba overiť pôvodnú odpoveď
Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.
Polia odpovede
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Aliasy
Aliasy modelov
Ailoot Ultra sourceful/riverflow-v2-pro
Aliasy ciest metód
/v1/images
Súvisiace ID na volanie
FAQ · Sourceful: Riverflow V2 Pro
- Aké vstupy a výsledky sú dostupné?
POST /v1/images/generations·sourceful/riverflow-v2-pro:text,image→image- Aké polia používa požiadavka?
POST /v1/images/generations·sourceful/riverflow-v2-pro:model,prompt,resolution,aspect_ratio,n,input_references,provider- Aké limity platia?
POST /v1/images/generations·sourceful/riverflow-v2-pro:n.minimum:1;n.maximum:1