Riverflow 2.5 Fast è il profilo Fast della famiglia Riverflow 2.5 di Sourceful per generazione e modifica immagini. Si adatta all’iterazione creativa iniziale e a passaggi applicativi ripetibili in cui il brief richiede rapidamente un’immagine candidata utile. La famiglia combina un’istruzione scritta e immagini sorgente con un processo di modifica guidato dal ragionamento che valuta le candidate e applica correzioni. Pro è il profilo separato orientato alla qualità della stessa generazione.
Per l’esplorazione, definisci una domanda visiva per brief: ambientazione, composizione, disposizione del prodotto o cambiamento mirato a un’immagine esistente. Un riferimento originale del prodotto deve restare l’ancora mentre ambiente o ritaglio cambiano attorno a esso. Un’attività utile di catalogo può esplorare una scena da tavolo per una bottiglia, poi confrontare se l’immagine lascia spazio sufficiente al titolo approvato. Mantieni coerenti identità del prodotto e collocazione prevista fra candidate affinché il confronto riguardi la scelta creativa anziché un cambiamento accidentale di soggetto.
La valutazione personalizzata della famiglia 2.5 permette a una rubrica di esprimere cosa rende utile una candidata. Specifica criteri come confezione riconoscibile, scritte leggibili, illuminazione coerente e ritaglio pratico. Mantieni distinta quella rubrica dall’istruzione di generazione: una descrive l’immagine da creare, l’altra stabilisce la prospettiva con cui valutarla. Uno sforzo di ragionamento minore è utile nella prima esplorazione; la verifica aggiuntiva può poi essere diretta ai criteri mancati dalla prima candidata.
La preparazione dei riferimenti è centrale a una modifica mirata. Identifica quale immagine fornisce il prodotto e quale un’ambientazione, una grafica o un’atmosfera. Indica l’elemento da cambiare e le caratteristiche da preservare, come forma di un coperchio, colore dell’etichetta o nome leggibile del prodotto. Per un insieme di varianti correlate, mantieni stabili direzione della luce e descrizione stilistica cambiando la sola proprietà che distingue ogni risorsa. La consapevolezza contestuale della famiglia supporta immagini di prodotto e campagne, ma il brief deve comunque fornire fatti e riferimenti che identificano l’articolo.
Font Control può usare fino a due file di font personalizzati forniti nel flusso 2.5. Dai titolo e didascalia esatti, collocazione e ruolo del font di ciascuno. Pochi blocchi testuali ben definiti rendono la gerarchia più facile da valutare rispetto a un canvas denso con varie direzioni in conflitto. Controlla ortografia, numeri, interruzioni di riga e peso nell’immagine risultante alle dimensioni d’uso previste. L’immagine è un risultato renderizzato, non un file di composizione tipografica modificabile o un’interfaccia funzionante.
La famiglia include flussi con sfondo normale, a tinta unita e trasparente. Prepara un ritaglio trasparente quando l’immagine deve essere composta in un altro layout oppure uno sfondo uniforme controllato quando un insieme di prodotti richiede una base visiva comune. Usa una scena finita per un’immagine di campagna. Scegli risoluzione e ritaglio disponibili per la collocazione effettiva dell’output, poi controlla dettagli visibili di prodotto e testo anziché presumere che un canvas maggiore da solo ne stabilisca l’accuratezza.
Fast è distinto da Pro e dalla generazione 2.0. Riverflow 2.5 aggiunge ragionamento più profondo, criteri personalizzati di verifica e controlli migliorati di font e sfondo al precedente approccio in più passaggi. Per un ciclo utile di iterazione, conserva la candidata adatta alla composizione, identifica il problema residuo preciso e rivedi quella parte del brief o della rubrica. Mantieni insieme immagine selezionata, riferimenti sorgente e criteri di verifica affinché i cambiamenti successivi sviluppino la stessa creatività anziché riavviarne l’identità.
", "aboutText": "Riverflow 2.5 Fast è il profilo Fast della famiglia Riverflow 2.5 di Sourceful per generazione e modifica immagini. Si adatta all’iterazione creativa iniziale e a passaggi applicativi ripetibili in cui il brief richiede rapidamente un’immagine candidata utile. La famiglia combina un’istruzione scritta e immagini sorgente con un processo di modifica guidato dal ragionamento che valuta le candidate e applica correzioni. Pro è il profilo separato orientato alla qualità della stessa generazione.\n\nPer l’esplorazione, definisci una domanda visiva per brief: ambientazione, composizione, disposizione del prodotto o cambiamento mirato a un’immagine esistente. Un riferimento originale del prodotto deve restare l’ancora mentre ambiente o ritaglio cambiano attorno a esso. Un’attività utile di catalogo può esplorare una scena da tavolo per una bottiglia, poi confrontare se l’immagine lascia spazio sufficiente al titolo approvato. Mantieni coerenti identità del prodotto e collocazione prevista fra candidate affinché il confronto riguardi la scelta creativa anziché un cambiamento accidentale di soggetto.\n\nLa valutazione personalizzata della famiglia 2.5 permette a una rubrica di esprimere cosa rende utile una candidata. Specifica criteri come confezione riconoscibile, scritte leggibili, illuminazione coerente e ritaglio pratico. Mantieni distinta quella rubrica dall’istruzione di generazione: una descrive l’immagine da creare, l’altra stabilisce la prospettiva con cui valutarla. Uno sforzo di ragionamento minore è utile nella prima esplorazione; la verifica aggiuntiva può poi essere diretta ai criteri mancati dalla prima candidata.\n\nLa preparazione dei riferimenti è centrale a una modifica mirata. Identifica quale immagine fornisce il prodotto e quale un’ambientazione, una grafica o un’atmosfera. Indica l’elemento da cambiare e le caratteristiche da preservare, come forma di un coperchio, colore dell’etichetta o nome leggibile del prodotto. Per un insieme di varianti correlate, mantieni stabili direzione della luce e descrizione stilistica cambiando la sola proprietà che distingue ogni risorsa. La consapevolezza contestuale della famiglia supporta immagini di prodotto e campagne, ma il brief deve comunque fornire fatti e riferimenti che identificano l’articolo.\n\nFont Control può usare fino a due file di font personalizzati forniti nel flusso 2.5. Dai titolo e didascalia esatti, collocazione e ruolo del font di ciascuno. Pochi blocchi testuali ben definiti rendono la gerarchia più facile da valutare rispetto a un canvas denso con varie direzioni in conflitto. Controlla ortografia, numeri, interruzioni di riga e peso nell’immagine risultante alle dimensioni d’uso previste. L’immagine è un risultato renderizzato, non un file di composizione tipografica modificabile o un’interfaccia funzionante.\n\nLa famiglia include flussi con sfondo normale, a tinta unita e trasparente. Prepara un ritaglio trasparente quando l’immagine deve essere composta in un altro layout oppure uno sfondo uniforme controllato quando un insieme di prodotti richiede una base visiva comune. Usa una scena finita per un’immagine di campagna. Scegli risoluzione e ritaglio disponibili per la collocazione effettiva dell’output, poi controlla dettagli visibili di prodotto e testo anziché presumere che un canvas maggiore da solo ne stabilisca l’accuratezza.\n\nFast è distinto da Pro e dalla generazione 2.0. Riverflow 2.5 aggiunge ragionamento più profondo, criteri personalizzati di verifica e controlli migliorati di font e sfondo al precedente approccio in più passaggi. Per un ciclo utile di iterazione, conserva la candidata adatta alla composizione, identifica il problema residuo preciso e rivedi quella parte del brief o della rubrica. Mantieni insieme immagine selezionata, riferimenti sorgente e criteri di verifica affinché i cambiamenti successivi sviluppino la stessa creatività anziché riavviarne l’identità.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "0e168c08d5aa2d859b4885f89f8082a86956b74b90e65b7f1071d0f847e96831", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "sourceful/riverflow-v2.5-fastRiverflow 2.5 Fast è il profilo Fast di Sourceful per generare e modificare immagini di prodotto e marketing. Usalo per esplorare composizioni e modifiche mirate nel flusso della famiglia guidato dal ragionamento, con riferimenti, tipografia e criteri di verifica chiari.
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
Riverflow 2.5 Fast è il profilo Fast della famiglia Riverflow 2.5 di Sourceful per generazione e modifica immagini. Si adatta all’iterazione creativa iniziale e a passaggi applicativi ripetibili in cui il brief richiede rapidamente un’immagine candidata utile. La famiglia combina un’istruzione scritta e immagini sorgente con un processo di modifica guidato dal ragionamento che valuta le candidate e applica correzioni. Pro è il profilo separato orientato alla qualità della stessa generazione.
Per l’esplorazione, definisci una domanda visiva per brief: ambientazione, composizione, disposizione del prodotto o cambiamento mirato a un’immagine esistente. Un riferimento originale del prodotto deve restare l’ancora mentre ambiente o ritaglio cambiano attorno a esso. Un’attività utile di catalogo può esplorare una scena da tavolo per una bottiglia, poi confrontare se l’immagine lascia spazio sufficiente al titolo approvato. Mantieni coerenti identità del prodotto e collocazione prevista fra candidate affinché il confronto riguardi la scelta creativa anziché un cambiamento accidentale di soggetto.
La valutazione personalizzata della famiglia 2.5 permette a una rubrica di esprimere cosa rende utile una candidata. Specifica criteri come confezione riconoscibile, scritte leggibili, illuminazione coerente e ritaglio pratico. Mantieni distinta quella rubrica dall’istruzione di generazione: una descrive l’immagine da creare, l’altra stabilisce la prospettiva con cui valutarla. Uno sforzo di ragionamento minore è utile nella prima esplorazione; la verifica aggiuntiva può poi essere diretta ai criteri mancati dalla prima candidata.
La preparazione dei riferimenti è centrale a una modifica mirata. Identifica quale immagine fornisce il prodotto e quale un’ambientazione, una grafica o un’atmosfera. Indica l’elemento da cambiare e le caratteristiche da preservare, come forma di un coperchio, colore dell’etichetta o nome leggibile del prodotto. Per un insieme di varianti correlate, mantieni stabili direzione della luce e descrizione stilistica cambiando la sola proprietà che distingue ogni risorsa. La consapevolezza contestuale della famiglia supporta immagini di prodotto e campagne, ma il brief deve comunque fornire fatti e riferimenti che identificano l’articolo.
Font Control può usare fino a due file di font personalizzati forniti nel flusso 2.5. Dai titolo e didascalia esatti, collocazione e ruolo del font di ciascuno. Pochi blocchi testuali ben definiti rendono la gerarchia più facile da valutare rispetto a un canvas denso con varie direzioni in conflitto. Controlla ortografia, numeri, interruzioni di riga e peso nell’immagine risultante alle dimensioni d’uso previste. L’immagine è un risultato renderizzato, non un file di composizione tipografica modificabile o un’interfaccia funzionante.
La famiglia include flussi con sfondo normale, a tinta unita e trasparente. Prepara un ritaglio trasparente quando l’immagine deve essere composta in un altro layout oppure uno sfondo uniforme controllato quando un insieme di prodotti richiede una base visiva comune. Usa una scena finita per un’immagine di campagna. Scegli risoluzione e ritaglio disponibili per la collocazione effettiva dell’output, poi controlla dettagli visibili di prodotto e testo anziché presumere che un canvas maggiore da solo ne stabilisca l’accuratezza.
Fast è distinto da Pro e dalla generazione 2.0. Riverflow 2.5 aggiunge ragionamento più profondo, criteri personalizzati di verifica e controlli migliorati di font e sfondo al precedente approccio in più passaggi. Per un ciclo utile di iterazione, conserva la candidata adatta alla composizione, identifica il problema residuo preciso e rivedi quella parte del brief o della rubrica. Mantieni insieme immagine selezionata, riferimenti sorgente e criteri di verifica affinché i cambiamenti successivi sviluppino la stessa creatività anziché riavviarne l’identità.
POST /v1/images/generationstext, imageimage| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti sourceful/riverflow-v2.5-fast | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 | Predefinito— |
Camporesolution | Tipostring | RequisitoFacoltativo | Valori e limiti 1K, 2K | Predefinito— |
Campoaspect_ratio | Tipostring | RequisitoFacoltativo | Valori e limiti 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Predefinito— |
Campooutput_format | Tipostring | RequisitoFacoltativo | Valori e limiti jpeg | Predefinito— |
Campobackground | Tipostring | RequisitoFacoltativo | Valori e limiti auto, transparent, opaque | Predefinito— |
Campon | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 1 Massimo: 1 | Predefinito— |
Campoinput_references | Tipoarray | RequisitoFacoltativo | Valori e limiti Numero minimo di elementi: 0 Numero massimo di elementi: 4 | Predefinito— |
Campoprovider | Tipoobject | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt |
Parametromaterial_types | Contrattotext, image |
Ciclo di vita: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effettivamente restituito o record della libreria multimediale
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Unità di fatturazione | Costo |
|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Unità di fatturazione— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| Configurazioneimmagine in uscita | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper immagine in output | Costo Output · immagine in uscita · Stima solo a fini di confronto $0.038 per immagine in output |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Unità di fatturazione— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.038 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'sourceful/riverflow-v2.5-fast', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nScarica ogni immagine restituita o salvane il contenuto Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nSalva ogni immagine completata; recupera ogni URL restituito oppure decodificane il contenuto Base64.
Conserva la risposta completa e gli header, ogni output effettivo, gli identificatori originali restituiti e tutti i campi di utilizzo. Recupera l'operazione originale senza inviare nuovamente la richiesta di creazione.
Conserva l'X-Client-Request-ID restituito per la riconciliazione. Leggi solo i valori task_id/asset_id effettivamente restituiti o la tua libreria multimediale; non costruire mai un URL del task a partire dall'ID dell'operazione e non reinviare mai la richiesta di creazione.
| Campo | Tipo |
|---|---|
Campocreated | Tipo |
Campodata[].url | Tipo |
Campodata[].b64_json | Tipo |
Campousage | Tipo |
Ailoot Ultra sourceful/riverflow-v2.5-fast
/v1/images