API de geração de vídeo com IA: texto para vídeo em TypeScript

Uma API de geração de vídeo com IA transforma um prompt num vídeo através de uma execução assíncrona: inicie o Video Generator, consulte o ID devolvido e leia o URL do vídeo nos recursos da execução concluída. O SDK TypeScript do Pipe2 expõe diretamente estas operações públicas, por isso uma integração de texto para vídeo pode manter-se simples.

Executar texto para vídeo com o SDK TypeScript

Instale @pipe2-ai/sdk, guarde um token Pipe2 em PIPE2_TOKEN e execute este módulo com Node. O exemplo usa uma ação observável e uma linha temporal curta, dando ao gerador um plano claro para produzir.

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));
}

O mesmo pedido ao pipeline, separado da autenticação e da consulta de estado, é:

{
  "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."
  }
}

A documentação do SDK TypeScript abrange instalação, autenticação, execuções, consulta de estado, subscrições, carregamentos e operações de créditos.

Compreender o fluxo de execução, consulta e recurso

RunPipeline recebe o slug do pipeline e um objeto JSON de entrada. Devolve os identificadores da nova execução em vez de manter o pedido aberto até a geração terminar. Guarde run_pipeline.run_id, pois é o identificador utilizado por GetPipelineRun.

Cada consulta devolve o registo atual. Uma execução completed pode conter os recursos gerados, e o exemplo apresenta o URL do primeiro. Uma execução failed inclui uma mensagem de erro que a integração deve mostrar ou registar. Em produção, defina ainda um limite de tempo global e trate uma execução ausente como erro, em vez de consultar indefinidamente.

Uma consulta a cada poucos segundos é suficiente para um pequeno script. Quando um serviço precisa de atualizações contínuas, o SDK também oferece WatchPipelineRun como iterável assíncrono sobre o mesmo estado.

Começar com a entrada válida mais simples

O pedido contém apenas prompt. Esta é a entrada útil mínima para texto para vídeo e deixa o seletor de modelo em Auto. O Video Generator também pode usar fotogramas iniciais ou finais e referências opcionais de imagem, vídeo ou áudio. As durações, resoluções, proporções e quantidades de referências suportadas dependem da rota de modelo compatível.

Adicione um controlo apenas quando o produto precisar dele. Uma proporção específica pode ser necessária para o destino, uma imagem para preservar a identidade ou um clip mais longo para outra rota compatível. Antes de enviar um pedido mais caro ou com mais ficheiros, chame EstimatePipelineCost com o mesmo pipeline_slug e input.

Escrever prompts adequados a um único plano

Uma API não elimina a necessidade de um briefing preciso. Descreva a ação visível, o comportamento da câmara, o ambiente, o tempo e o som. Mantenha a ação fisicamente possível dentro da duração pretendida.

O exemplo usa dois intervalos de tempo, mas um único acontecimento contínuo: o avião circula e depois pousa. Não pede uma mudança de local, várias personagens ou vários cortes. Assim, é mais fácil rever a continuidade do movimento, a forma do objeto, a aterragem e o áudio.

Numa produção maior, gere e aprove cada plano separadamente antes da montagem. O guia para criar vídeos com IA explica planeamento, revisão, montagem, legendas e acabamento após esta chamada à API.

Tratar explicitamente autenticação e falhas

Crie o cliente com um token Pipe2 e guarde-o no servidor ou numa variável de ambiente local segura. Não o coloque em código entregue ao navegador, não o confirme num repositório e não o inclua na entrada do pipeline.

Separe erros de envio de falhas da execução. Um pedido pode falhar antes de começar se não estiver autenticado, for inválido ou não conseguir reservar os créditos necessários. Uma execução criada com sucesso pode terminar depois como failed; consulte error_message. Use os URLs dos recursos apenas quando o estado for completed.

Se o processo começar com uma imagem, carregue-a ou referencie-a através do fluxo de recursos documentado no SDK e siga o guia prático de imagem para vídeo com IA.