Documentation

De l’inscription à votre première chronologie d’événements en cinq étapes :

1. 1Créez un compte sur le portail et connectez-vous.
2. 2Ouvrez Analyze et choisissez une source : un lien YouTube, l’URL directe d’une vidéo ou un fichier de votre ordinateur.
3. 3Sélectionnez le sport, ou laissez la détection automatique le choisir pour un lien YouTube.
4. 4Choisissez si vous le souhaitez l’équipe A et l’équipe B parmi vos équipes — les noms d’équipes améliorent la précision.
5. 5Lancez l’analyse, suivez sa progression en direct, puis ouvrez les résultats depuis History.

Inscrivez-vous sur le portail PitchView AI avec votre adresse e-mail et un mot de passe, puis connectez-vous. Votre profil indique depuis combien de temps vous êtes membre ainsi que le total de vos analyses et des événements détectés.

Avant votre première analyse, ajoutez les équipes avec lesquelles vous travaillez sur la page Teams. Au lancement d’une analyse, vous pouvez les rechercher et les sélectionner comme équipe A et équipe B, afin que les événements soient attribués au bon camp.

Si vous voulez que l’IA suive vos propres instructions, créez un prompt personnalisé sur la page Prompts.

Sur la page Analyze, choisissez le type de source. Pour un lien YouTube, vous pouvez aussi choisir la qualité vidéo à utiliser. Sélectionnez ensuite le sport et, si vous le souhaitez, les équipes et le prompt.

Une fois lancée, l’analyse passe par des étapes claires — téléchargement de la vidéo, extraction des métadonnées, envoi vers le stockage cloud et analyse par l’IA. Une vidéo type est traitée en 2 à 5 minutes.

Pour les matchs complets, utilisez Parallel : la vidéo est découpée en segments dont plusieurs sont analysés en même temps (trois par défaut), ce qui accélère fortement les longues vidéos.

Chaque résultat est une chronologie d’événements. Chaque événement comporte un horodatage, un type (par exemple but, faute ou corner), une description, l’équipe concernée et sa source — IA ou manuelle.

Cliquez sur un horodatage pour aller directement à ce moment de la vidéo. Vous pouvez rechercher les événements et les filtrer par type, statut de vérification et équipe.

Vous gardez la maîtrise des données : marquez chaque événement comme Correct, Wrong, Uncertain, Partial ou Duplicate (les nouveaux événements sont en Pending) avec un commentaire facultatif, modifiez ou supprimez des événements, ajoutez ceux que l’IA a manqués, ou relancez toute l’analyse avec Reanalyze.

Vous pouvez envoyer des fichiers MP4, MOV, AVI, MKV et WebM. Tout autre type de fichier est refusé avec un message indiquant les formats acceptés.

Vous n’êtes pas obligé d’envoyer un fichier : collez un lien YouTube ou un lien direct vers un fichier vidéo et PitchView AI récupère la vidéo pour vous.

Collez un lien YouTube sur la page Analyze. PitchView AI lit les qualités disponibles pour la vidéo afin que vous puissiez en choisir une, et peut détecter automatiquement le sport à partir de la vidéo.

La vidéo est téléchargée et conservée dans le stockage cloud pour l’analyse ; analyser à nouveau la même vidéo est donc plus rapide.

Seules les vidéos accessibles à PitchView AI peuvent être analysées — les vidéos privées ou supprimées ne peuvent pas être téléchargées.

Chaque fichier envoyé peut atteindre 500 Mo.

Si votre enregistrement est plus volumineux, analysez-le à partir d’un lien YouTube ou de l’URL directe de la vidéo plutôt que d’envoyer le fichier, et utilisez Parallel pour les matchs complets.

La plupart des problèmes d’envoi se règlent rapidement :

• Type de fichier non valide — convertissez la vidéo en MP4, MOV, AVI, MKV ou WebM.
• Fichier trop volumineux — les fichiers de plus de 500 Mo sont refusés ; compressez ou raccourcissez la vidéo, ou utilisez plutôt un lien.
• Les qualités ne se chargent pas pour un lien YouTube — vérifiez que le lien est correct et que la vidéo est publique, puis réessayez.
• Toujours bloqué ? Contactez le support avec l’identifiant de l’analyse indiqué dans History et nous examinerons le problème.

PitchView AI envoie votre vidéo aux modèles multimodaux Google Gemini avec un prompt rédigé pour le sport choisi. Le modèle regarde la vidéo et renvoie les événements qu’il repère, chacun avec un horodatage, un type, une description et une équipe.

Les événements sont enregistrés avec l’analyse ; vous pouvez donc les vérifier, les corriger et les exporter. Les longues vidéos peuvent être découpées en segments analysés en parallèle.

Le prompt indique à l’IA ce qu’elle doit chercher. PitchView AI propose des modèles de prompts système pour chaque sport, et la page Prompts vous permet de créer les vôtres : donnez-lui un nom, rédigez les instructions et utilisez-le pour vos prochaines analyses.

Les prompts personnalisés sont utiles quand certains moments vous intéressent particulièrement — par exemple uniquement les coups de pied arrêtés, ou les actions d’un joueur précis.

Les utilisateurs avancés peuvent régler le modèle d’IA depuis la page Prompts. Sans réglages personnalisés, les analyses utilisent les réglages par défaut, et les réglages utilisés sont affichés dans chaque analyse dans History.

• Modèle — choisi parmi les modèles Gemini disponibles : Flash est plus rapide et moins cher, Pro offre une meilleure qualité.
• Température — règle le caractère aléatoire, de 0,0 à 2,0 ; des valeurs basses donnent des résultats plus constants.
• Top-P et Top-K — limitent les tokens que le modèle envisage à chaque étape.
• Nombre maximal de tokens en sortie — la longueur maximale de la réponse du modèle.

La détection par l’IA est performante mais pas infaillible : elle peut manquer un événement, en mal interpréter un ou signaler deux fois le même moment. C’est pourquoi chaque événement peut être vérifié.

Vous obtenez les résultats les plus précis en choisissant le bon sport, en indiquant les noms des deux équipes, en utilisant une vidéo nette et de bonne qualité et en gardant des prompts ciblés.

Les statuts de vérification — Correct, Wrong, Uncertain, Partial et Duplicate — donnent un suivi clair de la fiabilité de chaque analyse, et ils sont inclus dans l’export.

Pendant l’analyse d’une vidéo, vous voyez chaque étape se mettre à jour en direct — téléchargement, métadonnées, envoi vers le cloud et analyse par l’IA — sans recharger la page.

Pour les matchs diffusés en direct avec PitchView, Stream analyse la diffusion pendant qu’elle se déroule : vous fixez la fenêtre d’analyse en secondes et le nombre maximal de minutes, et les événements détectés apparaissent sous Live events au fil du match.

Chaque analyse est enregistrée dans History, avec le nombre total d’analyses et d’événements et le sport que vous analysez le plus.

Recherchez par équipe, identifiant ou contenu, filtrez par sport et par statut, ouvrez une analyse pour vérifier ses événements, relancez-la avec Reanalyze ou supprimez les analyses dont vous n’avez plus besoin.

Dans une analyse, les événements sont listés par ordre chronologique. Cliquez sur un horodatage pour aller directement à ce moment de la vidéo.

Recherchez des événements par type, description ou équipe, filtrez-les par type, statut et équipe, et ajoutez un événement manuel à n’importe quel moment — les événements manuels sont signalés pour les distinguer de ceux de l’IA.

Utilisez Export sur n’importe quelle analyse pour télécharger ses événements dans un fichier Excel (.xlsx).

Chaque ligne contient l’heure, le temps en secondes, le type d’événement, la description, l’équipe, la source (IA ou manuelle), le statut de vérification, la date et l’auteur du changement de statut, ainsi que l’identifiant de l’événement — prêt à être partagé avec les entraîneurs et les analystes ou importé dans vos propres outils.

L’accès API est inclus dans les offres qui le mentionnent sur la page des tarifs.

Les informations d’authentification, la référence des endpoints, les limites d’utilisation et des exemples de code sont fournis lorsque l’accès API est activé pour votre compte. Contactez-nous pour commencer.