Skip to main content

Geração e Edição de Vídeo

Referência de comando da CLI Bailian para geração de vídeo, referência para vídeo e edição de vídeo.

Um único comando invoca as capacidades de geração e edição de vídeo do Bailian a partir do terminal.
Anexe --help a qualquer comando para obter detalhes completos dos parâmetros, por exemplo, bl video generate --help. Todo parâmetro que aceita uma URL de arquivo também aceita um caminho local — a CLI faz o upload automático para armazenamento temporário (válido por 48 horas), então você nunca precisa hospedar arquivos como URLs. Os detalhes dos comandos nesta página são verificados com o bl 2.8.0.

Referência de comando

bl video generate

Gera um vídeo a partir de texto ou imagem (wan3.0-video / wan2.6-t2v / happyhorse-1.1-i2v). Requer autenticação com chave de API. Uso
bl video generate --prompt <text> [--image <url>] [flags]
ParâmetroTipoObrigatórioDescrição
--model <model>stringNãoID do modelo (padrão: wan3.0-video)
--prompt <text>stringSimDescrição do vídeo
--image <url>stringNãoURL da imagem de entrada para geração de vídeo a partir de imagem
--last-frame <url>stringNãoURL da última imagem (com --image, habilita o modo first+last frame kf2v)
--negative-prompt <text>stringNãoPrompt negativo para excluir conteúdo indesejado
--resolution <res>stringNãoResolução: 720P ou 1080P (padrão: 1080P)
--ratio <ratio>stringNãoProporção de aspecto (por exemplo, 16:9, 9:16, 1:1)
--duration <seconds>numberNãoDuração do vídeo em segundos (padrão: 5)
--prompt-extend <bool>booleanNãoHabilitar extensão de prompt (true/false). Omita a flag para omitir o parâmetro (padrão do DashScope).
--watermark <bool>booleanNãoHabilitar marca d'água (true/false). Omita a flag para usar a configuração do Perfil ou padrão do CLI (true).
--seed <n>numberNãoSemente aleatória para geração reprodutível
--download <path>stringNãoSalvar vídeo em arquivo ao finalizar
--file <url-or-path>stringNãoURL ou caminho local do arquivo de referência para geração de vídeo (wan3.0-video apenas; mutuamente exclusivo com --image/--last-frame)
--primeswitchNãoUsar o modo Prime com um ponto de extremidade vinculado ao workspace
--workspace-id <id>stringNãoID do workspace para o ponto de extremidade Prime padrão (ou defina BAILIAN_WORKSPACE_ID)
--asyncswitchNãoRetornar ID da tarefa assíncrona sem esperar
--concurrent <n>numberNãoExecutar N requisições simultâneas (padrão: 1)
--poll-interval <seconds>numberNãoIntervalo de polling durante a espera (padrão: 5)
Exemplo: Gerar um vídeo a partir de uma descrição de texto
bl video generate --prompt "A person reading a book, static shot"
  • --model auto (ou um modelo padrão auto na configuração) roteia modelos AIGC automaticamente pelo MCP desenvolvido pela Bailian e usa apenas os parâmetros suportados pelas ferramentas MCP. Parâmetros incompatíveis, como --seed, --watermark, --prime e --async, falham com erro de uso em vez de recorrer ao REST.
  • O modo Prime exige um modelo explícito.
  • Ponto de extremidade Prime: configurado --base-url, DASHSCOPE_BASE_URL ou base_url do perfil tem precedência; caso contrário, o workspace é resolvido a partir de --workspace-id, BAILIAN_WORKSPACE_ID, depois do workspace de configuração.

bl video ref

Geração de vídeo a partir de referência (wan3.0-video / happyhorse-1.1-r2v / wan2.6-r2v): múltiplos sujeitos, múltiplas cenas com voz. Requer autenticação com chave de API. Uso
bl video ref --prompt <text> --image <url>... [--ref-video <url>...] [flags]
ParâmetroTipoObrigatórioDescrição
--model <model>stringNãoID do modelo (padrão: wan3.0-video)
--prompt <text>stringSimDescrição do vídeo com marcadores de referência (image1, video1, etc.)
--image <url>arrayNãoURL da imagem de referência ou arquivo local (repetível para múltiplos sujeitos)
--ref-video <url>arrayNãoURL do vídeo de referência ou arquivo local (repetível)
--image-voice <url>arrayNãoURL de voz para a imagem correspondente (pareados pela posição). Em wan3.0-video emitido como reference_audio (consulte Áudio 1, Áudio 2 na descrição)
--video-voice <url>arrayNãoURL de voz para o ref-video correspondente (pareados pela posição). Em wan3.0-video emitido como reference_audio (consulte Áudio 1, Áudio 2 na descrição)
--resolution <res>stringNãoResolução: 720P ou 1080P (padrão: 1080P)
--ratio <ratio>stringNãoProporção de aspecto (16:9, 9:16, 1:1)
--duration <seconds>numberNãoDuração do vídeo em segundos (padrão: 5)
--prompt-extend <bool>booleanNãoHabilitar extensão de prompt (true/false). Omita a flag para omitir o parâmetro (padrão do DashScope).
--watermark <bool>booleanNãoHabilitar marca d'água (true/false). Omita a flag para usar a configuração do Perfil ou padrão do CLI (true).
--seed <n>numberNãoSemente aleatória para geração reprodutível
--download <path>stringNãoSalvar vídeo em arquivo ao finalizar
--asyncswitchNãoRetornar ID da tarefa assíncrona sem esperar
--concurrent <n>numberNãoExecutar N requisições simultâneas (padrão: 1)
--poll-interval <seconds>numberNãoIntervalo de polling durante a espera (padrão: 15)
Exemplo: Criar um vídeo usando uma imagem de referência e descrição
bl video ref --prompt "Image1 running on the grass" --image person.jpg

bl video edit

Editar um vídeo com happyhorse-1.0-video-edit (transferência de estilo, substituição de objeto, etc.). Requer autenticação com chave de API. Uso
bl video edit --video <url> --prompt <text> [flags]
ParâmetroTipoObrigatórioDescrição
--model <model>stringNãoID do modelo (padrão: happyhorse-1.0-video-edit)
--video <url>stringSimURL do vídeo de entrada ou arquivo local (mp4/mov, 2-10s)
--prompt <text>stringNãoInstrução de edição (por exemplo, "Converter a cena inteira para estilo de animação de argila")
--ref-image <url>stringNãoURL da imagem de referência (até 4, separadas por vírgula)
--negative-prompt <text>stringNãoPrompt negativo para excluir conteúdo indesejado
--resolution <res>stringNãoResolução: 720P ou 1080P (padrão: 1080P)
--ratio <ratio>stringNãoProporção de aspecto (16:9, 9:16, 1:1, 4:3, 3:4)
--duration <seconds>numberNãoDuração do vídeo de saída em segundos (2-10)
--audio-setting <mode>stringNãoÁudio: auto (padrão) ou origin (manter original)
--prompt-extend <bool>booleanNãoHabilitar extensão de prompt (true/false). Omita a flag para omitir o parâmetro (padrão do DashScope).
--watermark <bool>booleanNãoHabilitar marca d'água (true/false). Omita a flag para usar a configuração do Perfil ou padrão do CLI (true).
--seed <n>numberNãoSemente aleatória para geração reprodutível
--download <path>stringNãoSalvar vídeo em arquivo ao finalizar
--asyncswitchNãoRetornar ID da tarefa assíncrona sem esperar
--concurrent <n>numberNãoExecutar N requisições simultâneas (padrão: 1)
--poll-interval <seconds>numberNãoIntervalo de polling durante a espera (padrão: 15)
Exemplo: Editar um vídeo com mudanças de estilo ou objetos
bl video edit --video https://example.com/input.mp4 --prompt "Convert the entire scene to claymation style"

bl video download

Baixar um vídeo concluído por ID de tarefa. Requer autenticação com chave de API. Uso
bl video download --task-id <id> --out <path>
ParâmetroTipoObrigatórioDescrição
--task-id <id>stringSimID da tarefa para baixar
--out <path>stringSimCaminho do arquivo de saída
Exemplo: Baixar um vídeo por ID de tarefa
bl video download --task-id 3b256896-xxxx --out video.mp4

bl video task get

Consultar o status de uma tarefa assíncrona. Requer autenticação com chave de API. Uso
bl video task get --task-id <id>
ParâmetroTipoObrigatórioDescrição
--task-id <id>stringSimID da tarefa assíncrona
Exemplo: Verificar o status de uma tarefa de vídeo assíncrona
bl video task get --task-id 3b256896-3e70-xxxx-xxxx-xxxxxxxxxxxx