Vos utilisateurs savent déjà ce qu'est un clip court. Ce qu'ils n'ont pas, c'est un moyen d'en fabriquer un dans votre app sans sauter vers un autre onglet et revenir avec un fichier. Avec l'API de Picasso IA, votre app envoie une requête par génération, en nommant un modèle vidéo et ses entrées, et le clip terminé revient sous forme de fichier que vous pouvez afficher, conserver et relire. La requête est la partie facile. Le vrai travail, c'est le produit autour : l'attente, les crédits, la modération, le stockage et les droits.
Une fonction vidéo change ce à quoi sert votre produit. Une app de cartes qui anime la carte, un carnet de voyage qui transforme une photo en carte postale animée, un outil de jeu qui crée une courte intro pour un personnage, un tableau de bord de boutique qui prépare le brouillon d'un clip produit : dans chaque cas l'utilisateur reste là où son travail vit déjà, au lieu d'exporter, de convertir et d'importer.
L'autre raison, c'est le choix. Le catalogue de Picasso IA compte 502 modèles, dont 121 dans la catégorie texte vers vidéo et 28 autres en montage vidéo. Pour quelqu'un qui construit, cela compte, car aucun modèle vidéo n'est le meilleur partout. L'un gère bien une personne, un autre suit de près une consigne de caméra, un autre est l'option la moins chère pour un brouillon. L'API est pensée pour atteindre le même catalogue que le toolkit et le même système de crédits, vous n'enfermez donc pas votre fonction dans les manies d'un seul moteur.
Le cadrage honnête : c'est une manière de proposer de la génération, pas de garantir des résultats. Chaque clip que créent vos utilisateurs est un modèle qui interprète un prompt, et votre produit doit être conçu autour de ce fait, pas malgré lui.
Avant toute architecture, notez les trois ou quatre choses qu'une personne fait dans votre fonction. La plupart des fonctions vidéo se réduisent au même petit ensemble d'actions, et les nommer tôt garde l'interface honnête.
La première est le texte vers vidéo : l'utilisateur décrit une scène et un mouvement en une ou deux phrases et reçoit un clip. La deuxième est l'image vers vidéo : il joint une image qui lui appartient, comme une photo de produit, un dessin ou un portrait de lui-même, et demande qu'elle bouge. La troisième est la nouvelle tentative : le premier clip est proche mais faux, il change un mot et génère à nouveau. La quatrième, si votre produit en a besoin, est une petite retouche ensuite, comme couper, agrandir ou ajouter du son, que d'autres modèles du catalogue couvrent. Pour voir comment fonctionne la deuxième action, transformer des photos en vidéos en fait le tour dans le toolkit.
Rien dans cette liste n'exige que l'utilisateur sache quel modèle a tourné. Vous pouvez proposer un sélecteur ou choisir pour lui.
Cinq préoccupations décident si une fonction vidéo paraît solide ou frustrante. Aucune n'est un problème de programmation et toutes ont une version que l'utilisateur voit. Ce tableau est la feuille de planification : ce que vit l'utilisateur et la décision qui vous revient.
| Préoccupation | Ce que vit votre utilisateur | La décision qui vous revient |
|---|
| Temps d'attente | Un clip n'est pas instantané, l'écran a donc besoin d'un état pour cela | Afficher la progression, laisser partir et revenir, ou prévenir |
| Crédits | Chaque génération coûte des crédits qui dépendent du modèle et des réglages | Répercuter le coût, l'absorber ou limiter le nombre de clips par personne |
| Modération | Certains prompts ou images ne devraient jamais devenir un clip | Filtrer les entrées, relire les sorties et décider ce que fait un signalement |
| Stockage | Le fichier renvoyé doit vivre là où on peut le retrouver | Où il est conservé, combien de temps et qui peut le supprimer |
| Droits | Le clip peut montrer un visage, une voix ou un design qui appartient à quelqu'un | Exiger que seuls du matériel personnel ou des sujets fictifs soient envoyés |
Le temps d'attente mérite le plus d'attention de conception, car c'est ce que l'utilisateur ressent. Générer prend un vrai temps et varie selon le modèle et les réglages, construisez donc pour une fourchette et non pour un chiffre. Celui qui peut continuer à utiliser votre app pendant qu'un clip se génère pardonne une longue attente.
Les crédits sont l'autre sujet discret. Le coût vient du modèle et des réglages choisis, et la page des tarifs est l'endroit où vivent les forfaits. Décidez tôt si vos utilisateurs voient les crédits, car cela change votre interface : une app qui dépense vos crédits à leur place a besoin de limites, et une app qui les répercute a besoin d'un prix clair avant le clic.
Règle de conception: traitez le clip comme un résultat qui arrive plus tard, pas comme une réponse que vous attendez. Si votre écran ne marche que lorsque la réponse est rapide, il échouera la première fois qu'un modèle sera lent.
Vous pouvez exécuter presque toute cette boucle aujourd'hui sans rien écrire, car le toolkit fait tourner le même catalogue que l'API est censée exposer. Servez-vous-en pour décider ce que votre fonction doit demander aux utilisateurs, puis reproduisez la même forme dans votre app.
- Testez le prompt dans le toolkit. Ouvrez le toolkit, choisissez un modèle vidéo comme veo-3.1 ou kling-v3-video et écrivez le type exact de prompt que vos utilisateurs écriraient, y compris les mauvais.
- Créez une clé dans votre compte. L'API fonctionne avec une clé que vous créez dans votre compte. Traitez-la comme un mot de passe : gardez-la sur votre serveur, jamais dans une app que les gens téléchargent ni dans une page qu'ils peuvent inspecter.
- Envoyez une requête par clip. Votre serveur nomme le modèle et les entrées, un prompt et, pour les modèles qui animent une image, une image. Votre app prévient aussitôt l'utilisateur que son clip est en cours de création.
- Attendez, puis récupérez le fichier. Le résultat revient sous forme de fichier que vous pouvez télécharger. Passez-le par votre étape de relecture, puis conservez-le là où l'utilisateur pourra le retrouver.
- Affichez le clip et comptez les crédits. Placez le clip dans la bibliothèque de l'utilisateur, notez ce que la génération a coûté et comparez les totaux avec le forfait de votre compte.
Faites l'étape un avec une douzaine de vrais prompts avant l'étape trois. Les prompts qu'un inconnu écrit sont à l'origine de vos décisions de modération.
Inutile de vous fixer sur un seul modèle pour toute la fonction. Pensez en rôles, testez-en quelques-uns dans le toolkit et choisissez selon le cas d'usage. Ce sont des modèles qui existent aujourd'hui dans le catalogue, tous dans la catégorie texte vers vidéo, qui contient aussi les variantes image vers vidéo.
Pour un résultat haut de gamme sur un moment fort, commencez par veo-3.1 de google ou kling-v3-video de kwaivgi. Pour des clips courts et joueurs, seedance-2.0 de bytedance et hailuo-2.3 de minimax méritent un essai. wan-3 d'alibaba et sora-2 d'openai complètent une première comparaison, et ltx-2.3-fast de lightricks est le nom à essayer pour voir comment un modèle plus léger se comporte sur des brouillons.
Ne le lisez pas comme un classement. Passez les mêmes trois prompts dans chacun, regardez les visages, les mains, le mouvement et le respect du prompt, et notez quel modèle l'emporte pour quel travail. Si votre produit transforme des images fixes en clips, la page vidéos de démonstration de produit avec l'IA montre ce qu'une photo de produit doit avoir pour survivre à l'animation. Parcourez la liste complète dans le catalogue avant de figer votre sélection.
Une API de génération vous donne des clips. Elle ne vous donne pas un produit vidéo. Voici les limites à prévoir, pour qu'aucune n'arrive par surprise après le lancement.
- Temps: chaque clip met un moment à se générer et la durée dépend du modèle et des réglages. Votre interface a besoin d'un état d'attente, d'un moyen de revenir plus tard et d'un plan pour une requête qui échoue.
- Coût: chaque génération dépense des crédits et les modèles plus lourds en dépensent davantage. Une fonction sans limites peut consommer des crédits plus vite que prévu, fixez donc des plafonds avant que le premier utilisateur ne le fasse.
- Variation: les modèles diffèrent, et le même prompt donne des résultats différents sur des moteurs différents, et même d'un essai à l'autre. Vous ne pouvez pas promettre un clip précis, seulement une tentative.
- Relecture: les sorties peuvent contenir des mains étranges, du texte fondu ou un visage qui dérive. Quelqu'un, ou une règle, doit regarder les clips avant qu'ils n'apparaissent là où d'autres les voient.
- Droits: le fichier que vous recevez ne règle pas à qui appartient ce qu'il montre. Vos conditions doivent dire que les utilisateurs n'envoient que du matériel personnel ou des sujets fictifs, jamais l'image d'une personne réelle sans son accord.
Rien de tout cela n'est un argument contre la fonction. C'est un argument pour la cadrer : clips courts, état d'attente clair, crédits visibles et étape de relecture. Une petite fonction prévisible vaut mieux qu'une grande qui surprend les gens.
Mes utilisateurs peuvent-ils vraiment générer de la vidéo sans quitter mon app ?
C'est le but de l'API de Picasso IA. Votre serveur envoie une requête par clip, en nommant un modèle et ses entrées, et le résultat revient sous forme de fichier que vous pouvez télécharger et afficher dans vos propres écrans. Vos utilisateurs ne voient jamais un autre site. Ce qu'ils remarqueront, c'est l'attente, car un clip met du temps à se générer, si bien que l'expérience dépend d'un bon état de progression plus que de tout le reste.
Ai-je besoin d'une clé d'API et comment la traiter ?
Oui. L'accès fonctionne avec une clé que vous créez dans votre compte, et elle doit être traitée comme un mot de passe. Gardez-la sur votre serveur, chargez-la depuis un coffre de secrets ou une variable d'environnement, et ne la mettez jamais dans une app mobile, un paquet de navigateur ou un dépôt public. Si vous pensez qu'elle a fuité, remplacez-la depuis votre compte et mettez à jour votre serveur. Vos utilisateurs n'ont jamais besoin de la voir.
Quels modèles puis-je proposer dans une fonction vidéo ?
Le catalogue compte 121 modèles texte vers vidéo et 28 de montage vidéo, sur 502 au total, et le toolkit les fait tous tourner aujourd'hui. Parmi les noms à tester d'abord figurent veo-3.1, kling-v3-video, seedance-2.0, hailuo-2.3, wan-3 et sora-2. Consultez la page de chaque modèle pour savoir ce qu'il accepte, car certains prennent seulement un prompt et d'autres peuvent partir d'une image. Passez vos propres prompts dans le toolkit avant de choisir.
Combien de temps mes utilisateurs attendront-ils un clip ?
Cela dépend du modèle, de la durée et des réglages, cette page ne donne donc aucun chiffre. Prévoyez une fourchette : certains clips reviendront vite et d'autres mettront nettement plus longtemps. La conception sûre consiste à confirmer la requête aussitôt, montrer qu'un travail est en cours, laisser la personne continuer à utiliser votre app et la prévenir quand le fichier est prêt. Testez les modèles choisis dans le toolkit pour sentir les vraies attentes.
Comment fonctionnent les crédits quand mes utilisateurs génèrent des clips ?
Générer coûte des crédits et le montant dépend du modèle et des réglages choisis. L'API est pensée pour utiliser le même système de crédits que le toolkit, ce que vous y voyez est donc ce qu'il faut attendre. Les forfaits et leurs allocations sont sur la page des tarifs, et les nouveaux comptes reçoivent des crédits gratuits pour tester. Vous décidez si vous absorbez le coût, le répercutez sur vos utilisateurs ou limitez le nombre de clips par personne.
Que dois-je modérer dans une fonction vidéo ?
À deux endroits : ce qui entre et ce qui sort. Pour les entrées, décidez quels prompts et images envoyées vous refusez, comme des images de personnes réelles qui n'ont pas accepté d'apparaître. Pour les sorties, relisez les clips avant de les partager publiquement, car les modèles peuvent produire des résultats étranges ou indésirables. Donnez aux utilisateurs un moyen de signaler un clip et décidez de la suite. Vos propres conditions d'utilisation doivent dire tout cela clairement.
Où dois-je stocker les clips générés ?
Le résultat revient sous forme de fichier que vous pouvez télécharger, la conservation vous revient donc. Enregistrez-le dans un stockage que vous contrôlez, lié à l'utilisateur qui l'a demandé, et décidez combien de temps il reste et qui peut le supprimer. Ne comptez pas sur le fichier renvoyé pour rester disponible indéfiniment. Si les clips peuvent être partagés, prévoyez les règles d'accès dès le départ.
À qui appartiennent les clips que mes utilisateurs génèrent ?
Vérifiez deux choses. D'abord, les droits sur l'entrée : un utilisateur qui envoie la photo de son propre produit n'est pas dans la même position que celui qui envoie l'œuvre d'un autre, et le générateur ne change pas à qui appartient ce qu'une image montre. Ensuite, les conditions de votre forfait pour les sorties. Placez vos propres règles devant les utilisateurs et faites relire par une personne qualifiée si les clips sont vendus ou publiés à des fins commerciales.
Les utilisateurs peuvent-ils animer des photos d'eux-mêmes ou d'autres personnes ?
Seulement d'eux-mêmes, de quelqu'un qui a clairement donné son accord ou d'un personnage fictif. Jamais une personne réelle identifiable sans son accord, et jamais la photo d'un mineur envoyée par quelqu'un d'autre. Intégrez cela à votre écran d'envoi avec une ligne courte et claire, et à vos conditions. Une règle claire vaut mieux qu'un filtre astucieux.
Que faire si un clip est raté ou si une requête échoue ?
Prévoyez les deux cas. Les clips ratés sont normaux : laissez les utilisateurs modifier le prompt et réessayer, et montrez le coût en crédits d'une nouvelle tentative avant qu'ils n'appuient sur le bouton. Les requêtes qui échouent ont besoin d'un message clair et d'un moyen de réessayer. Si quelque chose semble cassé de votre côté ou si vous avez une question sur votre compte, le support est la voie directe vers une personne.
Une bonne façon de commencer est de tester les clips que vos utilisateurs demanderaient. Ouvrez le toolkit, passez quelques vrais prompts dans deux ou trois modèles vidéo et notez ce que votre fonction doit promettre.