Résumez cet article avec :
- Eden AI fournit une API simple et conviviale pour les développeurs qui vous permet de suivre les personnes dans les vidéos.
- Maintenant que vous avez initialisé les modules JavaScript requis et obtenu votre clé API, vous serez en mesure de suivre les personnes dans les vidéos.
- API de suivi des personnes vous permet de suivre les personnes et leur activité au sein d'une scène ou d'un segment.
- Le fonctionnement du suivi des personnes est simple : la détection des personnes identifie les personnes dans une vidéo, puis les suit au fil du temps en fonction de leur visage, de leurs vêtements ou de leur posture.
- L'API de suivi des personnes peut être utilisée comme un outil autonome, ou elle peut être combinée avec détection de visage pour générer des résultats plus précis.
Dans ce tutoriel, vous apprendrez à utiliser l'API de suivi des personnes en 5 minutes à l'aide de JavaScript et de l'API de suivi des personnes Eden AI. Eden AI fournit une API simple et conviviale pour les développeurs qui vous permet de suivre les personnes dans les vidéos.
Qu'est-ce que l'API Video Person Tracking ?
API de suivi des personnes vous permet de suivre les personnes et leur activité au sein d'une scène ou d'un segment. Le fonctionnement du suivi des personnes est simple : la détection des personnes identifie les personnes dans une vidéo, puis les suit au fil du temps en fonction de leur visage, de leurs vêtements ou de leur posture.

L'API de suivi des personnes peut être utilisée comme un outil autonome, ou elle peut être combinée avec détection de visage pour générer des résultats plus précis. Vous pouvez utiliser le suivi des personnes pour analyser des situations très complexes, telles que des scènes bondées avec plusieurs personnes, des zones de transport bondées telles que des aéroports, des trains et des stations de métro.
Premiers pas avec l'API de suivi des personnes par vidéo
La première étape pour commencer à utiliser l'API de suivi des personnes consiste à configurer Axios, un client HTTP basé sur des promesses pour le navigateur et Node.js, qui vous permettra d'appeler l'API Eden AI.
.png)
Ensuite, vous devez initialiser le module Système de fichiers pour accéder aux fichiers locaux de votre ordinateur.
.png)
Enfin, vous devrez créer votre formulaire de paramètres multipart/formdata :

Comment utiliser l'API de suivi des personnes avec JavaScript
Vous êtes maintenant prêt à traiter votre fichier vidéo dans l'API de suivi des personnes d'Eden AI.
1. Obtenez votre clé API de suivi des personnes sur Eden AI
Pour effectuer le suivi des personnes, vous devez créer un compte sur Eden AI gratuitement. Ensuite, vous pourrez obtenir votre Clé API directement depuis la page d'accueil avec des crédits gratuits offerts par Eden AI.
2. Faisons le suivi des personnes présentes dans votre fichier vidéo
Maintenant que vous avez initialisé les modules JavaScript requis et obtenu votre clé API, vous serez en mesure de suivre les personnes dans les vidéos. Le suivi des personnes dans les vidéos passe désormais par un LLM multimodal qui accepte la vidéo en entrée, appelé via l'endpoint de chat compatible OpenAI d'Eden AI : le modèle liste les personnes avec une courte description et les intervalles de temps où elles apparaissent, plutôt que des cadres de délimitation image par image. Vous pouvez utiliser tout modèle dont les input_modalities contiennent video : consultez notre documentation ici.
Voici le code JavaScript pour ajouter votre vidéo au formulaire et définir votre clé API :
form.append("file", fs.createReadStream("path/to/your/video.mp4"));
const apiKey = "Your_API_Key";
Une fois le fichier ajouté, vous pouvez configurer vos requêtes : la vidéo est d'abord envoyée à Eden AI, qui renvoie un file_id, puis la requête demande à un LLM multimodal, ici google/gemini-2.5-flash, de suivre les personnes et de répondre dans le format JSON défini par le schéma :
// Step 1: upload your video to Eden AI, which returns a file_id
const uploadOptions = {
method: "POST",
url: "https://api.edenai.run/v3/upload",
headers: {
authorization: `Bearer ${apiKey}`,
...form.getHeaders(),
},
data: form,
};
// Step 2: ask a multimodal LLM to track the people, with the JSON format of the answer
const schema = {
type: "object",
properties: {
persons: {
type: "array",
items: {
type: "object",
properties: {
person: { type: "string" },
start_time: { type: "number" },
end_time: { type: "number" },
},
required: ["person", "start_time", "end_time"],
},
},
},
required: ["persons"],
};
const options = (fileId) => ({
method: "POST",
url: "https://api.edenai.run/v3/chat/completions",
headers: {
authorization: `Bearer ${apiKey}`,
},
data: {
model: "google/gemini-2.5-flash", // any model with video in its input_modalities
messages: [
{
role: "user",
content: [
{ type: "text", text: "List the people who appear in this video, each with a short description and the time range in seconds where they appear." },
{ type: "file", file: { file_id: fileId } },
],
},
],
response_format: { type: "json_schema", json_schema: { name: "persons", schema: schema } },
},
});
Ensuite, vous devrez créer la fonction launchJob () qui exécutera la requête POST :
.png)
Enfin, créez la fonction run() qui envoie la vidéo, lance la requête et lit la réponse. Il n'y a pas de tâche à interroger, car le résultat arrive dans la même réponse :
const run = async () => {
const upload = await axios.request(uploadOptions);
const response = await launchJob(options(upload.data.file_id));
console.log(response.data);
// The answer is a JSON string that follows the schema
const result = JSON.parse(response.data.choices[0].message.content);
console.log(result.persons);
};
run().catch((error) => {
console.error(error.response ? error.response.data : error);
});
Vous obtiendrez cette réponse, dans laquelle le modèle répond par une chaîne JSON placée dans choices[0].message.content :
{
"status": "success",
"model": "gemini-2.5-flash",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "{\n \"persons\": [\n {\n \"person\": \"Sintel\",\n \"start_time\": 5,\n \"end_time\": 8\n },\n {\n \"person\": \"Elder\",\n \"start_time\": 12,\n \"end_time\": 13\n },\n {\n \"person\": \"Sintel\",\n \"start_time\": 14,\n \"end_time\": 15\n },\n {\n \"person\": \"Sintel\",\n \"start_time\": 17,\n \"end_time\": 17\n },\n {\n \"person\": \"Thug\",\n \"start_time\": 17,\n \"end_time\": 17\n },\n {\n \"person\": \"Sintel\",\n \"start_time\": 19,\n \"end_time\": 20\n },\n {\n \"person\": \"Sintel\",\n \"start_time\": 22,\n \"end_time\": 23\n },\n {\n \"person\": \"Sintel\",\n \"start_time\": 24,\n \"end_time\": 25\n },\n {\n \"person\": \"Sintel\",\n \"start_time\": 27,\n \"end_time\": 35\n },\n {\n \"person\": \"Dragon (Scales)\",\n \"start_time\": 25,\n \"end_time\": 35\n },\n {\n \"person\": \"Sintel\",\n \"start_time\": 37,\n \"end_time\": 41\n }\n ]\n}"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 15635,
"completion_tokens": 747,
"total_tokens": 16382
},
"provider": "google",
"cost": 0.0077277
}
Une fois analysée, cette chaîne JSON donne le résultat de la tâche de suivi des personnes (les intervalles de temps sont estimés par le modèle, vérifiez-les sur quelques-unes de vos vidéos avant de vous y fier en production) :
[
{
"person": "Sintel",
"start_time": 5,
"end_time": 8
},
{
"person": "Elder",
"start_time": 12,
"end_time": 13
},
{
"person": "Sintel",
"start_time": 14,
"end_time": 15
},
{
"person": "Sintel",
"start_time": 17,
"end_time": 17
},
...
]
Avantages de l'utilisation de l'API de suivi des personnes avec Eden AI
L'utilisation du suivi des personnes avec l'API Eden AI est rapide et facile.
.gif)
Économisez du temps et de l'argent
Nous proposons une API unifiée pour tous les fournisseurs : simple et standard à utiliser, avec un changement rapide d'un fournisseur à l'autre et un accès aux fonctionnalités spécifiques de chaque fournisseur.
Facile à intégrer
Le format de sortie JSON est le même pour tous les fournisseurs grâce au travail de standardisation d'Eden AI. Les éléments de réponse sont également standardisés grâce aux puissants algorithmes de correspondance d'Eden AI.
Personnalisation
Avec Eden AI, vous avez la possibilité d'intégrer une plateforme tierce : nous pouvons développer rapidement des connecteurs. Pour aller plus loin et personnaliser votre demande de suivi des personnes avec des paramètres spécifiques, consultez notre documentation.
.png)

