Sourceful: Riverflow V2.5 Fast
O Riverflow 2.5 Fast é o perfil Fast da Sourceful para gerar e editar imagens de produto e marketing. Utilize-o para explorar composições e edições focadas no fluxo da família orientado por raciocínio, com referências, tipografia e critérios de revisão claros.
Sobre o modelo
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
O Riverflow 2.5 Fast é o perfil Fast da família de geração e edição de imagens Riverflow 2.5 da Sourceful. Adequa-se à iteração criativa inicial e a etapas repetíveis de aplicação nas quais o briefing precisa rapidamente de uma imagem candidata útil. A família combina uma instrução escrita e imagens de origem com um processo de edição orientado por raciocínio que avalia candidatos e faz correções. O Pro é o perfil separado da mesma geração focado na qualidade.
Para exploração, defina uma questão visual por briefing: o cenário, a composição, a disposição do produto ou uma alteração focada de uma imagem existente. Uma referência original de produto deve continuar a ser a âncora enquanto o ambiente ou o recorte mudam à sua volta. Uma tarefa útil de catálogo pode explorar uma cena de mesa para uma garrafa e comparar depois se a imagem deixa espaço suficiente para o título aprovado. Mantenha a identidade do produto e o posicionamento pretendido consistentes entre candidatos, para que a comparação incida na escolha criativa, e não numa alteração acidental do tema.
A avaliação personalizada da família 2.5 permite que uma grelha expresse o que torna um candidato útil. Especifique critérios como embalagem reconhecível, letras legíveis, iluminação coerente e recorte prático. Mantenha essa grelha distinta da instrução de geração: uma descreve a imagem a criar, enquanto a outra define a perspetiva usada para a avaliar. Um esforço de raciocínio menor é útil na fase inicial de exploração; a revisão adicional pode depois incidir nos critérios que o primeiro candidato não cumpriu.
A preparação de referências é central numa edição focada. Identifique qual a imagem que fornece o produto e qual fornece um cenário, um trabalho gráfico ou um ambiente. Indique o elemento a alterar e as características a preservar, como a forma de uma tampa, a cor do rótulo ou um nome de produto legível. Para um conjunto de variantes relacionadas, mantenha estáveis a direção da iluminação e a descrição do estilo, alterando a propriedade que distingue cada peça. A compreensão de contexto da família apoia imagens de produto e campanha, mas o briefing continua a ter de fornecer os factos e as referências que identificam o artigo.
O Font Control pode utilizar até dois ficheiros de tipos de letra personalizados fornecidos no fluxo 2.5. Indique o título e a legenda exatos, o seu posicionamento e a função tipográfica de cada um. Um pequeno número de blocos de texto bem definidos torna a hierarquia mais fácil de avaliar do que uma tela densa com várias orientações contraditórias. Reveja a ortografia, os números, as quebras de linha e o peso tipográfico na imagem resultante, no tamanho em que será utilizada. A imagem é um artefacto renderizado, e não um ficheiro de composição tipográfica editável ou uma interface funcional.
A família inclui fluxos de fundo normal, de cor uniforme e transparente. Prepare um recorte transparente quando a imagem tiver de ser integrada noutra composição, ou um fundo uniforme controlado quando um conjunto de produtos precisar de uma base visual comum. Utilize uma cena concluída para uma imagem de campanha. Escolha a resolução e o recorte disponíveis para o posicionamento real da saída e verifique depois os pormenores visíveis do produto e do texto, em vez de assumir que uma tela maior, por si só, estabelece a sua exatidão.
O Fast distingue-se do Pro e da geração 2.0. O Riverflow 2.5 acrescenta raciocínio mais profundo, critérios de revisão personalizados e controlos melhorados de tipos de letra e fundo à abordagem anterior de várias etapas. Para um ciclo de iteração útil, mantenha o candidato adequado à composição, identifique o problema restante preciso e reveja essa parte do briefing ou da grelha. Guarde a imagem selecionada, as referências de origem e os critérios de revisão em conjunto, para que as alterações seguintes desenvolvam a mesma peça criativa, em vez de reiniciarem a sua identidade.
Ailoot Ultra · Imagens POST /v1/images/generations sourceful/riverflow-v2.5-fast
sourceful/riverflow-v2.5-fastIntrodução
O Riverflow 2.5 Fast é o perfil Fast da Sourceful para gerar e editar imagens de produto e marketing. Utilize-o para explorar composições e edições focadas no fluxo da família orientado por raciocínio, com referências, tipografia e critérios de revisão claros.
- Entradas aceites
- Texto · Imagens
- Resultados
- Imagens
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · Imagens POST /v1/images/generations
- Entrada
text,image- Saída
image
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites sourceful/riverflow-v2.5-fast | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 | Predefinição— |
Camporesolution | Tipostring | RequisitoOpcional | Valores e limites 1K, 2K | Predefinição— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores e limites 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Predefinição— |
Campooutput_format | Tipostring | RequisitoOpcional | Valores e limites jpeg | Predefinição— |
Campobackground | Tipostring | RequisitoOpcional | Valores e limites auto, transparent, opaque | Predefinição— |
Campon | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 1 | Predefinição— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores e limites Número mínimo de elementos: 0 Número máximo de elementos: 4 | Predefinição— |
Campoprovider | Tipoobject | RequisitoOpcional | Valores e limites | Predefinição— |
Parâmetros e ciclo de vida do método
| 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 efetivamente devolvido ou registo na biblioteca de multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifários
Cálculo do custo final
As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
- Modo rápido
- Não especificado Quando o modo rápido está selecionado
- Modo flex
- Não especificado Quando o modo flex está selecionado
- Esforço máximo de raciocínio
- Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Tarifas estimadas para comparação
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Tabela de tarifas | Quantidade prevista | Unidade de faturação | Custo |
|---|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Unidade de faturação— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação — / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação — / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação — / 1K tokens |
| Configuraçãoimagem de saída | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor imagem de saída | Custo Saída · imagem de saída · Estimativa apenas para comparação $0.038 por imagem de saída |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Unidade de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $0.038 estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída. |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
Exemplos de pedidos
Ailoot Ultra · Imagens
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.5-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
Receber e guardar os resultados
Ailoot Ultra · Imagens
Descarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Outras leituras de conteúdo
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.
Guardar todos os resultados concluídos
Guarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo Base64.
Conserve a resposta completa e os cabeçalhos, todos os resultados efetivamente produzidos, os identificadores originais devolvidos e todos os campos de utilização. Recupere a operação original sem voltar a enviar o pedido de criação.
Se for necessário verificar a resposta original
Guarde o X-Client-Request-ID devolvido para reconciliação. Consulte apenas os valores task_id/asset_id efetivamente devolvidos ou a sua biblioteca de multimédia; nunca construa um URL de tarefa a partir do ID da operação e nunca volte a enviar o pedido de criação.
Campos da resposta
| Campo | Tipo |
|---|---|
Campocreated | Tipo |
Campodata[].url | Tipo |
Campodata[].b64_json | Tipo |
Campousage | Tipo |
Aliases
Aliases do modelo
Ailoot Ultra sourceful/riverflow-v2.5-fast
Aliases dos caminhos dos métodos
/v1/images
IDs de chamada relacionados
FAQ · Sourceful: Riverflow V2.5 Fast
- Que entradas e resultados estão disponíveis?
POST /v1/images/generations·sourceful/riverflow-v2.5-fast:text,image→image- Que campos utiliza o pedido?
POST /v1/images/generations·sourceful/riverflow-v2.5-fast:model,prompt,resolution,aspect_ratio,output_format,background,n,input_references,provider- Que limites se aplicam?
POST /v1/images/generations·sourceful/riverflow-v2.5-fast:n.minimum:1;n.maximum:1