Sourceful: Riverflow V2 Fast
Riverflow 2.0 Fast es el perfil Fast de Sourceful para crear imágenes y realizar ediciones visuales enfocadas. Utiliza referencias claras de producto y estilo para explorar imágenes de marketing dentro de un flujo de varios pasos que revisa candidatos y conserva la tipografía y el detalle.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
Riverflow 2.0 Fast es el perfil Fast de la familia de generación y edición de imágenes Riverflow 2.0 de Sourceful. Es útil para explorar una dirección visual o realizar una edición claramente especificada antes de refinar la creatividad seleccionada. La familia añade a la generación de imágenes revisión y corrección de candidatos guiadas por razonamiento, con atención a la tipografía de marca y el detalle de producto. Pro es el perfil independiente de la misma generación para trabajos sensibles a la calidad.
Prepara un encargo enfocado con el sujeto, el entorno, la iluminación y un cambio visual que explorar. Una tarea práctica inicial puede colocar un envase flexible de producto sobre una superficie de cocina, dejando una zona definida para un titular. Proporciona la referencia que establece la forma, el color y la etiqueta del envase y describe después el entorno, en lugar de pedir un anuncio completamente indefinido. Mantén fijas las características importantes del producto al comparar entornos o recortes diferentes.
Para editar, indica directamente el cambio solicitado e identifica los detalles circundantes que deben permanecer intactos. Sustituir un fondo, ajustar la composición o cambiar un accesorio secundario no debe convertir el producto principal en un SKU nuevo. La familia 2.0 revisa candidatos y realiza correcciones durante varios pasos, por lo que el encargo necesita un objetivo concreto en lugar de una petición general de una imagen más bonita. Conserva la imagen de origen al inspeccionar si el cambio mantuvo el objeto y su texto visible.
El flujo de control de fuentes de la familia admite fuentes públicas o personalizadas proporcionadas, con hasta dos fuentes y 300 caracteres por imagen en la versión 2.0. Proporciona las palabras exactas y la función tipográfica de cada bloque. Un titular y un pie de texto pequeño pueden definir una jerarquía útil sin convertir todo el lienzo en un documento denso. Comprueba la ortografía, los números, el espaciado y las letras pequeñas al tamaño de visualización previsto. Un texto representado es contenido visual, no un sustituto de un archivo de diseño editable.
Para problemas de detalle que persistan en una escena generada, el flujo independiente de superresolución 2.0 basado en referencias puede utilizar ilustraciones de alta calidad para reparar el texto y los detalles de etiquetas de producto. La publicación describe hasta cuatro instancias de sustitución, en un mismo producto o repartidas entre varios de la composición. Conserva las ilustraciones originales para que una reparación se guíe por el diseño real. Es una etapa posterior de conservación de detalle alrededor de la imagen, no una instrucción para suponer que todos los primeros candidatos ya sean exactos.
Un conjunto útil de recursos mantiene coherentes la iluminación, el estilo visual y las referencias de producto mientras varía la escena o colocación previstas. Para un catálogo, registra la referencia de producto y el encargo de la imagen junto con la salida seleccionada. Para una campaña, compara si el recorte deja espacio para el texto aprobado y si el producto sigue siendo reconocible. Elige qué candidato refinar según la tarea real, sin perder los requisitos originales a medida que se desarrolla la dirección visual.
Fast sigue siendo distinto de Pro y de los controles más recientes de evaluación personalizada de Riverflow 2.5. Una instrucción posterior enfocada puede corregir una etiqueta, eliminar un objeto secundario o ajustar la disposición conservando las partes logradas de la escena. La entrega útil es una imagen seleccionada vinculada a su fuente y ubicación prevista, con reparación tipográfica o de detalle posterior guiada por la ilustración original y el detalle específico que necesita corregirse.
Ailoot Ultra · Imágenes POST /v1/images/generations sourceful/riverflow-v2-fast
sourceful/riverflow-v2-fastPrimeros pasos
Riverflow 2.0 Fast es el perfil Fast de Sourceful para crear imágenes y realizar ediciones visuales enfocadas. Utiliza referencias claras de producto y estilo para explorar imágenes de marketing dentro de un flujo de varios pasos que revisa candidatos y conserva la tipografía y el detalle.
- Entradas aceptadas
- Texto · Imágenes
- Resultados
- Imágenes
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Imágenes POST /v1/images/generations
- Tipos de entrada
text,image- Tipos de salida
image
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites sourceful/riverflow-v2-fast | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 | Predeterminado— |
Camporesolution | Tipostring | RequisitoOpcional | Valores y límites 1K, 2K, 4K | Predeterminado— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores y límites 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Predeterminado— |
Campon | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 Máximo: 1 | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores y límites Número mínimo de elementos: 0 Número máximo de elementos: 4 | Predeterminado— |
Campoprovider | Tipoobject | RequisitoOpcional | Valores y límites | Predeterminado— |
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt |
Parámetromaterial_types | Contratotext, image |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id real devuelto o registro de la biblioteca multimedia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Planes
Cómo se calcula el cargo definitivo
Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen la cantidad facturable final.
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)
Tarifas estimadas para comparar
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad prevista | Unidad de facturación | Cargo |
|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Unidad de facturación— | Cargo Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens |
| ConfiguraciónEntrada de fuente tipográfica | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor imagen | Cargo Entrada · Entrada de fuente tipográfica · Estimación solo para comparar $0.06 por imagen |
| ConfiguraciónReferencia de entrada | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor imagen | Cargo Entrada · Referencia de entrada · Estimación solo para comparar $0.4 por imagen |
| Configuraciónimagen de salida | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor imagen de salida | Cargo Salida · imagen de salida · Estimación solo para comparar $0.04 por imagen de salida |
| ConfiguraciónCoste estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Cargo Salida · Coste estimado de generación · Estimación solo para comparar $0.04 estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija para la generación completada. |
Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
Ailoot Ultra · Imágenes
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
Recibir y guardar resultados
Ailoot Ultra · Imágenes
Descarga cada imagen recibida o guarda su contenido Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Otras consultas de contenido
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.
Conserva todos los resultados completados
Guarda todas las imágenes completadas; descarga cada URL recibida o decodifica su contenido Base64.
Conserva la respuesta completa y las cabeceras, todas las salidas reales, los identificadores originales devueltos y todos los campos de uso. Recupera la operación original sin volver a enviar la solicitud de creación.
Si es necesario revisar la respuesta original
Conserva el X-Client-Request-ID devuelto para la conciliación. Consulta únicamente los valores task_id/asset_id realmente devueltos o la biblioteca multimedia propia; nunca construyas una URL de tarea a partir del ID de la operación ni vuelvas a enviar la solicitud de creación.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campocreated | Tipo |
Campodata[].url | Tipo |
Campodata[].b64_json | Tipo |
Campousage | Tipo |
Alias
Alias del modelo
Ailoot Ultra sourceful/riverflow-v2-fast
Alias de rutas de métodos
/v1/images
ID de modelo relacionados
FAQ · Sourceful: Riverflow V2 Fast
- ¿Qué entradas y resultados están disponibles?
POST /v1/images/generations·sourceful/riverflow-v2-fast:text,image→image- ¿Qué campos utiliza la solicitud?
POST /v1/images/generations·sourceful/riverflow-v2-fast:model,prompt,resolution,aspect_ratio,n,input_references,provider- ¿Qué límites se aplican?
POST /v1/images/generations·sourceful/riverflow-v2-fast:n.minimum:1;n.maximum:1