Sourceful: Riverflow V2 Pro

Riverflow 2.0 Pro es el perfil Pro de Sourceful para generar y editar imágenes que requieren especial cuidado de la identidad de marca. Su familia revisa y corrige candidatos, admite orientación de fuentes y ofrece reparación de detalles basada en referencias para etiquetas y material gráfico 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, empaque 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 ejecución confiable de un brief visual, tipografía y conservación de los detalles de producto que hacen útil un recurso para una marca.

Para una composición que requiera especial cuidado de la calidad, proporciona la imagen de producto o material gráfico, el texto exacto y la disposición visual prevista. Una escena útil puede colocar un frasco etiquetado junto a sus ingredientes y conservar la forma del envase y la jerarquía de etiqueta. Describe iluminación, fondo y recorte, y después indica qué detalles del producto no deben cambiar. El resultado es una imagen creativa renderizada; decidir cómo se integra en una campaña más amplia o en una composición editable es un paso independiente de aplicación.

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

El control de fuentes utiliza fuentes públicas o personalizadas proporcionadas para guiar 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 texto, jerarquía y grosor o espaciado previstos exactos en lugar de esperar que el modelo elija la redacción. Revisa glifos importantes, números, ligaduras y texto pequeño de apoyo en el recurso resultante. Mantener conciso el texto también deja espacio para el producto y la explicación visual.

El flujo de superresolución basado en referencias de la familia repara texto fino o material gráfico que una escena de menor resolución no contiene con exactitud. Proporciona material gráfico de origen de alta calidad para que la etapa de reparación de detalle tenga la etiqueta o el diseño real por reproducir. La versión 2.0 describe hasta cuatro instancias de sustitución por solicitud, permitiendo correcciones en un producto o varios dentro de una escena. Es un flujo de reparación basado en referencias alrededor de la imagen generada, no una garantía de que toda imagen inicial tenga microdetalle perfecto.

Para un conjunto relacionado de productos, mantén consistentes estilo, iluminación y estructura de escena mientras proporcionas la referencia correcta de cada artículo. Un recurso de campaña puede combinar una vista principal de producto con espacio práctico para texto aprobado; un acercamiento de producto puede priorizar detalle de etiqueta y material. Elige la preparación de origen y salida para el tamaño previsto de visualización, y conserva la imagen seleccionada con las referencias que establecen su identidad. Una corrección de escena y un paso de reparación de detalles atienden partes distintas 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 asumirse que esas configuraciones posteriores forman parte de este perfil 2.0. Para una revisión final útil, compara cambio solicitado, tipografía, identidad del producto y detalles circundantes con la fuente. Modifica la instrucción o referencia específica responsable de una discrepancia y conserva la composición que ya se adapta a la tarea.

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

sourceful/riverflow-v2-pro

Sourceful /sourceful/riverflow-v2-pro

Inicio

Entradas aceptadas: Texto · Imágenes
Resultados: Imágenes

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Imágenes POST /v1/images/generations

Entrada: text, image
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} · El task_id real devuelto o el registro de la biblioteca multimedia

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarifas

Cómo se calcula el cargo definitivo

Las tarifas mostradas permiten estimar el costo antes de la generación. El cargo final se calcula a partir del costo registrado para la generación original. La duración medida de la salida y las cantidades estimadas no son 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 fast: Sin especificar Cuando se selecciona el modo fast
Modo flex: Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento: Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste 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ónCosto estimado de generación	Tabla de tarifas—	Cantidad previstaestimación para una generación	Unidad de facturación—	Cargo Salida · Costo 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 por la generación completada.

Ailoot reserva un monto 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 los encabezados, 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 reales de task_id/asset_id devueltos o la biblioteca multimedia de tu propiedad; 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