Sourceful: Riverflow V2 Pro

Riverflow 2.0 Pro es el perfil Pro de generación y edición de imágenes de Sourceful para piezas creativas que requieren fidelidad a la marca. Su familia revisa y corrige candidatos, admite orientación tipográfica y ofrece reparación de detalles basada en referencias para etiquetas e ilustraciones de producto.

Ailoot Ultra · Imágenes POST /v1/images/generations sourceful/riverflow-v2-pro

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 Pro es el perfil Pro de la familia de generación y edición de imágenes Riverflow 2.0 de Sourceful para creatividad de producto, envases y marketing. Combina creación o edición de imágenes con un modelo de razonamiento que revisa candidatos y realiza correcciones. Sus prioridades distintivas son la ejecución fiable de un encargo visual, la tipografía y la conservación de los detalles de producto que hacen útil un recurso para una marca.

Para una composición sensible a la calidad, proporciona la imagen o ilustración de producto, el texto exacto y la disposición visual prevista. Una escena útil puede colocar un tarro etiquetado junto a sus ingredientes mientras conserva la forma del recipiente y la jerarquía de la etiqueta. Describe la iluminación, el fondo y el recorte e indica después qué detalles del producto no deben cambiar. El resultado es una imagen creativa representada; decidir cómo encaja en una campaña más amplia o en una composición editable es un paso separado de aplicación.

El flujo 2.0 evalúa automáticamente candidatos y corrige problemas durante varios pasos. Da a ese proceso un objetivo claro separando el contenido obligatorio de las elecciones opcionales de estilo. Para una edición, nombra el elemento que debe cambiar y las características circundantes que deben conservarse. Una actualización del color de producto no debe convertirse silenciosamente en un nuevo diseño de etiqueta, y una sustitución de fondo debe mantener reconocible el objeto proporcionado. La imagen terminada aún debe compararse con el encargo y las referencias de origen.

El control de fuentes utiliza fuentes públicas o personalizadas proporcionadas para orientar la tipografía de marca. Riverflow 2.0 admite hasta dos fuentes a la vez y hasta 300 caracteres por imagen en su flujo de control de fuentes. Proporciona el texto exacto, la jerarquía y el grosor o espaciado previstos en lugar de esperar que el modelo elija las palabras. Inspecciona los glifos importantes, las cifras, las ligaduras y el texto pequeño de apoyo en el recurso resultante. Mantener el texto conciso también deja espacio para el producto y la explicación visual.

El flujo de superresolución basado en referencias de la familia repara el texto fino o las ilustraciones que una escena de menor resolución no contiene con precisión. Proporciona ilustraciones originales de alta calidad para que la etapa de reparación de detalle tenga la etiqueta o el diseño reales que reproducir. La publicación 2.0 describe hasta cuatro instancias de sustitución por solicitud, lo que permite correcciones en un producto o en varios de una escena. Es un flujo de reparación basado en referencias alrededor de la imagen generada, no una garantía de que todas las imágenes iniciales tengan microdetalle perfecto.

Para un conjunto de productos relacionados, mantén coherentes el estilo, la iluminación y la estructura de escena mientras proporcionas la referencia correcta para cada artículo. Un recurso de campaña puede combinar una vista principal del producto con espacio práctico para texto aprobado; un primer plano de producto puede priorizar el detalle de la etiqueta y el material. Elige la preparación de origen y salida para el tamaño de visualización previsto y conserva la imagen seleccionada con las referencias que establecen su identidad. Una corrección a nivel de escena y un paso de reparación de detalle abordan partes diferentes del recurso.

Pro es distinto del perfil Fast y de Riverflow 2.5. La generación posterior añade criterios personalizados de puntuación y controles de revisión más profundos; no debe suponerse que esos ajustes posteriores formen parte de este perfil 2.0. Para una revisión final útil, comprueba el cambio solicitado, la tipografía, la identidad del producto y los detalles circundantes frente a la fuente. Revisa la instrucción o referencia específica responsable de una discrepancia y conserva la composición que ya encaja en la tarea.

Ailoot Ultra · Imágenes POST /v1/images/generations sourceful/riverflow-v2-pro

sourceful/riverflow-v2-pro

Sourceful /sourceful/riverflow-v2-pro

Primeros pasos

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
Campo`model`	Tipo`string`	RequisitoObligatorio	Valores y límites sourceful/riverflow-v2-pro	Predeterminado—
Campo`prompt`	Tipo`string`	RequisitoObligatorio	Valores y límites Longitud mínima: 1	Predeterminado—
Campo`resolution`	Tipo`string`	RequisitoOpcional	Valores y límites 1K, 2K, 4K	Predeterminado—
Campo`aspect_ratio`	Tipo`string`	RequisitoOpcional	Valores y límites 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Predeterminado—
Campo`n`	Tipo`integer`	RequisitoOpcional	Valores y límites Mínimo: 1 Máximo: 1	Predeterminado—
Campo`input_references`	Tipo`array`	RequisitoOpcional	Valores y límites Número mínimo de elementos: 0 Número máximo de elementos: 10	Predeterminado—
Campo`provider`	Tipo`object`	RequisitoOpcional	Valores y límites	Predeterminado—

Parámetros del método y ciclo de vida

Parámetro	Contrato
Parámetro`content_type`	Contratoapplication/json
Parámetro`required`	Contratomodel, prompt
Parámetro`material_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.3 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.3 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

curl

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

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}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Otras consultas de contenido

Consultar los archivos existentes que te pertenecen

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
Campo`created`	Tipo
Campo`data[].url`	Tipo
Campo`data[].b64_json`	Tipo
Campo`usage`	Tipo

Alias

Alias del modelo

Ailoot Ultra sourceful/riverflow-v2-pro

Alias de rutas de métodos

/v1/images

ID de modelo relacionados

sourceful/riverflow-v2-pro

FAQ · Sourceful: Riverflow V2 Pro

¿Qué entradas y resultados están disponibles?: POST /v1/images/generations · sourceful/riverflow-v2-pro: text, image → image
¿Qué campos utiliza la solicitud?: POST /v1/images/generations · sourceful/riverflow-v2-pro: model, prompt, resolution, aspect_ratio, n, input_references, provider
¿Qué límites se aplican?: POST /v1/images/generations · sourceful/riverflow-v2-pro: n.minimum: 1; n.maximum: 1

Sourceful: Riverflow V2 Pro