API de génération vidéo IA : du texte à la vidéo en TypeScript

Une API de génération vidéo IA transforme un prompt en vidéo au moyen d’une exécution asynchrone : lancez Video Generator, interrogez l’identifiant reçu, puis récupérez l’URL de la vidéo dans les ressources de l’exécution terminée. Le SDK TypeScript de Pipe2 expose directement ces opérations publiques, ce qui permet de garder une intégration texte-vers-vidéo concise.

Exécuter une génération texte-vers-vidéo avec le SDK TypeScript

Installez @pipe2-ai/sdk, placez un jeton Pipe2 dans PIPE2_TOKEN, puis exécutez ce module avec Node. L’exemple décrit une seule action observable et une chronologie courte afin de donner au générateur un plan clair à produire.

import { createClient } from '@pipe2-ai/sdk';

const input = {
  prompt: '[0-3s] A paper airplane circles above a classroom. [3-6s] It lands beside a notebook. Gentle room ambience, no music.',
};
const client = createClient(process.env.PIPE2_TOKEN);
const { run_pipeline } = await client.RunPipeline({
  pipeline_slug: 'video-generator',
  input,
});

while (true) {
  const { pipeline_runs_by_pk: run } = await client.GetPipelineRun({
    id: run_pipeline.run_id,
  });
  if (run?.status === 'completed') {
    console.log(run.assets?.[0]?.url);
    break;
  }
  if (run?.status === 'failed') throw new Error(run.error_message ?? 'Video generation failed');
  await new Promise((resolve) => setTimeout(resolve, 3000));
}

La même requête de pipeline, isolée de l’authentification et du suivi, est la suivante :

{
  "pipeline_slug": "video-generator",
  "input": {
    "prompt": "[0-3s] A paper airplane circles above a classroom. [3-6s] It lands beside a notebook. Gentle room ambience, no music."
  }
}

La documentation du SDK TypeScript détaille l’installation, l’authentification, les exécutions de pipeline, le suivi d’état, les abonnements, les téléversements et les opérations de crédits.

Comprendre le flux exécution, suivi et ressource

RunPipeline reçoit le slug du pipeline et un objet JSON d’entrée. L’opération renvoie les identifiants de la nouvelle exécution au lieu de garder la requête ouverte jusqu’à la fin de la génération. Conservez run_pipeline.run_id, car GetPipelineRun utilise cet identifiant.

Chaque interrogation renvoie l’enregistrement actuel. Une exécution completed peut contenir les ressources générées, et l’exemple affiche l’URL de la première. Une exécution failed fournit un message d’erreur que l’intégration doit afficher ou journaliser. En production, fixez aussi une durée maximale globale et considérez l’absence de l’exécution comme une erreur plutôt que de continuer indéfiniment.

Un suivi toutes les quelques secondes convient à un petit script. Pour un service qui a besoin de mises à jour continues, le SDK propose également WatchPipelineRun, un itérable asynchrone fondé sur le même état.

Commencer par l’entrée valable la plus simple

La requête ne contient que prompt. C’est l’entrée texte-vers-vidéo utile la plus petite, et le sélecteur de modèle reste sur Auto. Video Generator peut aussi recevoir des images de début ou de fin ainsi que des références facultatives d’image, de vidéo ou d’audio. Les durées, définitions, formats et limites de références compatibles dépendent de la route de modèle retenue.

N’ajoutez un réglage que si le produit l’exige. Un format précis peut être nécessaire pour la destination, une image de référence pour l’identité, ou un plan plus long pour une autre route compatible. Avant d’envoyer une requête plus coûteuse ou riche en médias, appelez EstimatePipelineCost avec les mêmes pipeline_slug et input.

Écrire un prompt adapté à un seul plan

Une API ne remplace pas un brief précis. Décrivez l’action visible, le comportement de la caméra, l’environnement, le déroulement et le son. L’action doit pouvoir se réaliser physiquement dans le temps prévu.

L’exemple emploie deux plages temporelles au sein d’un événement continu : l’avion tourne puis atterrit. Il ne demande ni changement de lieu, ni plusieurs personnages, ni montage. La continuité du mouvement, la forme de l’objet, l’atterrissage et le son sont ainsi plus faciles à contrôler.

Pour une production plus ambitieuse, générez et validez chaque plan avant l’assemblage. Le guide pour créer des vidéos avec l’IA aborde la planification, la vérification, le montage, les sous-titres et la finition après cet appel API.

Traiter explicitement l’authentification et les échecs

Créez le client avec un jeton Pipe2 et conservez-le sur le serveur ou dans une variable d’environnement locale protégée. Ne l’intégrez ni au code livré au navigateur, ni au dépôt, ni aux données d’entrée du pipeline.

Séparez les erreurs d’envoi des échecs d’exécution. La création peut échouer si la requête n’est pas authentifiée, si elle est invalide ou si les crédits requis ne peuvent pas être réservés. Une exécution correctement créée peut ensuite finir en failed ; consultez alors error_message. N’utilisez les URL de ressources qu’après l’état completed.

Si le processus part d’une image, téléversez-la ou référencez-la avec le flux de ressources documenté dans le SDK, puis suivez le guide pratique pour transformer une image en vidéo.