Guide Rivya des références et uploads
Planifiez les références Rivya, uploads audio, limites de fichiers, exigences de connexion, contrôles de sécurité, choix de modèle et exécution Studio.
Utilisez ce guide des références et uploads avant de choisir un modèle qui dépend de références image, de références vidéo ou d'audio uploadé.
Les références et uploads sont au coeur de la façon dont les tâches Rivya passent de la découverte à l'exécution connectée dans Studio.
Ils influencent :
le choix du modèle
le choix du workflow
la structure du prompt
le coût de la tâche
le fait que l'utilisateur doive commencer sur une page publique de démarrage, une page de détail de modèle ou Studio
C'est pourquoi les uploads ne sont pas seulement un détail d'interface. Ils font partie de la logique du workflow.
Un détail opérationnel compte dès le départ :
les pages compatibles avec les références peuvent être publiques
l'upload réel de fichiers exige actuellement une connexion
Une page publique de démarrage peut donc rester le bon endroit pour commencer, mais l'exécution basée sur upload n'est pas entièrement anonyme dans le produit actuel.
Trois formes d'upload
Aujourd'hui, le comportement des références et uploads dans Rivya se répartit principalement en trois formes :
références image
références vidéo
uploads audio
Tous les modèles ne prennent pas en charge les trois.
C'est pourquoi la page du modèle compte avant le début de la tâche.
Références image
De nombreux workflows image et vidéo prennent en charge les références image.
Selon le modèle, les limites de références image peuvent beaucoup varier.
Aujourd'hui, cette plage va de :
une seule image de référence
à des workflows multi-images plus larges
C'est important, car « prend en charge les références » et « prend en charge beaucoup de références » ne sont pas la même chose.
Références vidéo
Certains workflows vidéo peuvent aussi accepter des références vidéo ou d'autres modes de référence étendus.
Ce n'est pas universel dans tout le catalogue.
C'est pourquoi les utilisateurs ne doivent pas supposer que chaque modèle vidéo peut accepter le même type d'entrée simplement parce qu'il appartient à la même catégorie.
Uploads audio
Les uploads audio comptent surtout dans des workflows comme :
nettoyage audio
isolation audio
transformation audio
Ils sont structurellement différents de la génération audio qui commence par un prompt.
Si le modèle attend de l'audio uploadé, le formulaire se comporte différemment volontairement.
Pourquoi le formulaire change selon le modèle
Les formulaires de génération Rivya sont pilotés par le modèle.
Cela signifie que les entrées visibles dépendent de :
ce que le modèle sélectionné prend en charge
les types de fichiers qu'il accepte
le nombre de fichiers qu'il peut recevoir
C'est le bon comportement, car un modèle uniquement prompt et un modèle d'abord upload ne sont pas le même workflow.
Types d'upload actuels
Les principaux types d'upload utilisés dans les flux produit actuels sont :
imagevideoaudio
Ils sont normalisés dans le produit avant d'être envoyés dans la requête finale au modèle.
Limites d'upload actuelles
Le chemin d'upload applique actuellement des contrôles de taille et de type par catégorie :
Image
JPEG
PNG
WebP
taille maximale par défaut actuelle : 10 MB
Nano Banana 2etNano Banana Proautorisent actuellement jusqu'à 30 MB
Vidéo
MP4
MOV / QuickTime
WebM
taille maximale actuelle : 50 MB
Wan 2.6: Utilisez exactement 1 image JPG/PNG/WebP (256×256 minimum, 10 Mo maximum) ou 1–3 vidéos MP4/MOV (10 Mo maximum par fichier).
Audio
MP3
audio MP4
WAV
AAC
OGG
taille maximale par défaut actuelle : 10 MB
Ces limites concernent l'ingestion et le routage sûrs, pas seulement le confort d'interface.
Références et choix du modèle
La prise en charge des références compte souvent plus que le bruit autour d'un modèle.
Par exemple :
si le workflow a besoin de nombreuses références image, le bon modèle est rarement choisi uniquement par réputation de marque
si le workflow a besoin d'audio uploadé, un modèle TTS standard n'est pas le bon point d'entrée
C'est pourquoi l'ordre de sélection de modèle le plus propre est :
type de sortie
exigence de référence ou d'upload
adéquation coût et qualité
préférence de modèle seulement ensuite
Pages publiques vs Studio
Les pages publiques de démarrage sont utiles lorsque vous voulez :
une première landing page publique
une entrée directe propre à un modèle
un chemin venant de la recherche vers le bon workflow
Studio est préférable lorsque la tâche a besoin de :
upload et exécution connectés
itération répétée
plus de continuité
un contexte de travail plus complet
C'est particulièrement vrai une fois que l'upload lui-même devient une partie d'un workflow plus long.
Erreurs fréquentes
Erreur 1 : supposer que tous les modèles d'une catégorie acceptent les mêmes types de fichiers
Ce n'est pas le cas.
Erreur 2 : choisir un modèle avant de vérifier la prise en charge des uploads
Cela crée souvent du travail à refaire qui aurait pu être évité.
Erreur 3 : traiter les workflows d'audio uploadé comme des workflows uniquement prompt
Ce sont des chemins différents et ils doivent être traités différemment.
Workflow de référence
Un chemin pratique dans Rivya ressemble à ceci :
vérifier la page du modèle pour la prise en charge des références
choisir la bonne page de démarrage publique ou le bon chemin Studio
se connecter avant l'étape d'upload réelle si un contexte de compte est requis
uploader uniquement les types que le modèle prend réellement en charge
garder le prompt aligné avec le contexte uploadé
revoir le résultat et itérer dans le même workflow
À lire ensuite
Checklist d'upload de référence
Avant qu'une tâche dépende d'un fichier de référence ou d'un upload, vérifiez :
Confirmez si la tâche a besoin d'une référence image, d'une référence vidéo, d'un upload audio ou d'aucun fichier.
Vérifiez la page du modèle pour les types de fichiers et limites pris en charge avant de préparer les assets.
Décidez si la tâche appartient à une page de démarrage publique ou à Studio connecté.
Retirez les contenus sensibles ou inutiles du fichier avant upload.
Gardez le prompt aligné avec ce que chaque fichier uploadé doit contrôler.
L'objectif est de rendre le fichier utile, autorisé et pertinent avant de dépenser des crédits.
Quand revérifier l'adéquation de l'upload
Revérifiez l'adéquation de l'upload lorsque le modèle sélectionné change, qu'un fichier est trop volumineux, que le rôle d'une référence n'est pas clair ou que l'asset contient des personnes, logos, données privées ou contenus appartenant à un client.
Dans ces cas, consultez les Consignes d'upload sûr et la page de référence pertinente avant de lancer une autre exécution.
Journal des modifications API
Suivez les mises à jour de la documentation Rivya API v1, des endpoints, de la référence des modèles, du schéma et des futures surfaces.
Guide des références image Rivya
Utilisez les références image Rivya pour guider l'identité produit, la composition, le style, l'éclairage, la cohérence de marque, la génération et la revue des sorties.