Guia de Referências e Uploads da Rivya
Planeje referências, uploads de áudio, limites de arquivo, requisitos de login, verificações de segurança, escolha de modelo e execução no Studio da Rivya.
Use este guia de referências e uploads antes de escolher um modelo que depende de referências de imagem, referências de vídeo ou áudio enviado.
Referências e uploads são uma parte central de como tarefas da Rivya passam da descoberta para a execução autenticada no Studio.
Eles afetam:
escolha de modelo
escolha de fluxo de trabalho
estrutura do prompt
custo da tarefa
se o usuário deve começar em uma página pública inicial, detalhe de modelo ou Studio
É por isso que uploads não são apenas um detalhe de UI. Eles fazem parte da lógica do fluxo de trabalho.
Um detalhe operacional importa cedo:
páginas cientes de referências podem ser públicas
o upload real de arquivos atualmente exige login
Então uma página pública inicial ainda pode ser o lugar certo para começar, mas execução baseada em upload não é totalmente anônima no produto atual.
Três Formatos De Upload
Hoje, o comportamento de referências e uploads na Rivya cai principalmente em três formatos:
referências de imagem
referências de vídeo
uploads de áudio
Nem todo modelo oferece suporte aos três.
É por isso que a página do modelo importa antes de a tarefa começar.
Referências De Imagem
Muitos fluxos de imagem e vídeo oferecem suporte a referências de imagem.
Dependendo do modelo, limites de imagens de referência podem variar bastante.
Agora, esse intervalo vai de:
uma única imagem de referência
fluxos maiores de múltiplas imagens
Isso importa porque "oferece suporte a referências" e "oferece suporte a muitas referências" não são a mesma coisa.
Referências De Vídeo
Alguns fluxos de vídeo também podem aceitar referências de vídeo ou outros modos de referência estendidos.
Isso não é universal em todo o catálogo.
É por isso que usuários não devem presumir que todo modelo de vídeo aceita o mesmo tipo de entrada só porque pertence à mesma categoria.
Uploads De Áudio
Uploads de áudio importam mais em fluxos como:
limpeza de áudio
isolamento de áudio
transformação de áudio
Eles são estruturalmente diferentes da geração de áudio que começa por um prompt.
Se o modelo espera áudio enviado, o formulário se comporta de forma diferente de propósito.
Por Que O Formulário Muda Por Modelo
Os formulários de geração da Rivya são guiados por modelo.
Isso significa que as entradas visíveis dependem de:
o que o modelo selecionado oferece suporte
quais tipos de arquivo ele aceita
quantos arquivos ele pode receber
Esse é o comportamento correto, porque um modelo somente com prompt e um modelo que começa por upload não são o mesmo fluxo de trabalho.
Tipos Atuais De Upload
Os principais tipos de upload usados nos fluxos atuais do produto são:
imagevideoaudio
Eles são normalizados dentro do produto antes de serem enviados para a solicitação final do modelo.
Limites Atuais De Upload
O caminho de upload atualmente aplica verificações de tamanho e tipo por categoria:
Image
JPEG
PNG
WebP
tamanho máximo padrão atual: 10 MB
Nano Banana 2eNano Banana Proatualmente permitem até 30 MB
Video
MP4
MOV / QuickTime
WebM
tamanho máximo atual: 50 MB
Wan 2.6: Use exatamente 1 imagem JPG/PNG/WebP (mínimo 256×256, até 10 MB) ou 1–3 vídeos MP4/MOV (até 10 MB por arquivo).
Audio
MP3
MP4 audio
WAV
AAC
OGG
tamanho máximo padrão atual: 10 MB
Esses limites são sobre ingestão e roteamento seguros, não apenas conveniência de UI.
Referências E Escolha De Modelo
Suporte a referências muitas vezes importa mais do que hype.
Por exemplo:
se o fluxo precisa de muitas referências de imagem, o modelo certo raramente é escolhido apenas por reputação de marca
se o fluxo precisa de áudio enviado, um modelo TTS padrão é o ponto de entrada errado
É por isso que a ordem mais limpa de seleção de modelo é:
tipo de saída
requisito de referência ou upload
adequação de custo e qualidade
só então preferência de modelo
Páginas Públicas vs. Studio
Páginas públicas iniciais são boas quando você quer:
uma primeira landing page pública
uma entrada direta específica por modelo
um caminho vindo de busca para o fluxo certo
Studio é melhor quando a tarefa precisa de:
upload e execução autenticados
iteração repetida
mais continuidade
um contexto de trabalho mais completo
Isso é especialmente verdadeiro quando o próprio upload se torna parte de um fluxo mais longo.
Erros Comuns
Erro 1: Presumir que todos os modelos de uma categoria aceitam os mesmos tipos de arquivo
Eles não aceitam.
Erro 2: Escolher um modelo antes de verificar suporte a upload
Isso muitas vezes cria retrabalho evitável.
Erro 3: Tratar fluxos com áudio enviado como fluxos somente por prompt
São caminhos diferentes e devem ser tratados de forma diferente.
Fluxo De Referência
Um caminho prático na Rivya se parece com isto:
confira a página do modelo para suporte a referências
escolha a página pública inicial certa ou caminho de Studio
faça login antes da etapa real de upload se contexto de conta for necessário
envie apenas os tipos que o modelo realmente suporta
mantenha o prompt alinhado com o contexto enviado
revise o resultado e itere no mesmo fluxo
Leia A Seguir
Checklist De Upload De Referência
Antes de uma tarefa depender de um arquivo de referência ou upload, confira:
Confirme se a tarefa precisa de referência de imagem, referência de vídeo, upload de áudio ou nenhum arquivo.
Confira a página do modelo para tipos de arquivo e limites compatíveis antes de preparar ativos.
Decida se a tarefa pertence a uma página pública inicial ou ao Studio autenticado.
Remova conteúdo sensível ou desnecessário do arquivo antes do upload.
Mantenha o prompt alinhado com o que cada arquivo enviado deve controlar.
O objetivo é tornar o arquivo útil, permitido e relevante antes de gastar créditos.
Quando Reconfirmar A Adequação Do Upload
Reconfirme a adequação do upload quando o modelo selecionado mudar, um arquivo for grande demais, a função da referência não estiver clara ou o ativo contiver pessoas, logotipos, dados privados ou material pertencente a cliente.
Nesses casos, revise Diretrizes de Upload Seguro e a página de referência relevante antes de iniciar outra execução.
Changelog da API
Acompanhe atualizações da documentação, endpoints, referência de modelos, schema e superfícies futuras da Rivya API v1.
Guia de Referências de Imagem da Rivya
Use referências de imagem da Rivya para orientar identidade de produto, composição, estilo, iluminação, consistência de marca, geração e revisão da saída.