Pular para o conteúdo principal
POST
/
v3
/
async
/
vidu-2.0-reference2video
Vidu 2.0 Vídeo a partir de referência
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-2.0-reference2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "images": [
    "<string>"
  ],
  "prompt": "<string>",
  "duration": 123,
  "seed": 123,
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "movement_amplitude": "<string>",
  "bgm": true
}
'
{
  "task_id": "<string>"
}
O Vidu 2.0 Vídeo a partir de referência gera vídeos usando imagens de referência e descrições em texto. Ele oferece suporte a vários tipos de sujeitos, como personagens e objetos. Ao enviar vários ângulos de um sujeito, você pode criar vídeos que mantêm a consistência visual.
Esta é uma API assíncrona e retornará apenas o task_id da tarefa assíncrona. Você deve usar esse task_id para solicitar a API de consulta de resultado da tarefa e recuperar o resultado da geração do vídeo.

​
Cabeçalhos da requisição

​
Content-Type
string
obrigatório
Valores enumerados: application/json
​
Authorization
string
obrigatório
Formato de autenticação Bearer: Bearer {{API Key}}.

​
Corpo da requisição

​
images
string[]
obrigatório
O modelo usará as imagens fornecidas como referência para gerar um vídeo com um sujeito consistente.Requisitos do campo de imagem:
  • Aceita de 1 a 3 imagens
  • Os recursos de imagem podem ser fornecidos por URL ou codificação Base64
  • Deve usar um dos seguintes formatos: PNG, JPEG, JPG, WebP
  • As dimensões da imagem devem ser de pelo menos 128x128 pixels
  • A proporção da imagem deve ser menor que 1:4 ou 4:1
  • Todas as imagens são limitadas a 50MB
  • O tamanho após a decodificação base64 deve ser menor que 10MB e deve incluir a string de tipo de conteúdo apropriada. Por exemplo:
data:image/png;base64,{base64_encode}
​
prompt
string
obrigatório
Prompt de texto para geração de vídeo, com comprimento máximo de 1500 caracteres.
​
duration
integer
Duração do vídeo (em segundos). Padrão: 4 segundos. Opções: 4.
​
seed
integer
Semente aleatória para a geração do vídeo.
  • O padrão é um valor de semente aleatória
  • Um valor definido manualmente substituirá a semente aleatória padrão
​
aspect_ratio
string
Proporção do vídeo de saída. Valor padrão: 16:9
Valores disponíveis: 16:9, 9:16, 1:1
​
resolution
string
O parâmetro de resolução é 360p por padrão; as opções são 360p e 720p.
​
movement_amplitude
string
Amplitude do movimento dos objetos na cena. Valor padrão: auto
Valores disponíveis: auto, small, medium, large
​
bgm
boolean
Indica se música de fundo deve ser adicionada ao vídeo gerado. Valor padrão: false
Valores disponíveis: true, falseQuando definido como true, o sistema adicionará automaticamente uma BGM adequada. A BGM não tem limite de duração; o sistema fará a adaptação automaticamente.

​
Informações da resposta

​
task_id
string
obrigatório
O task_id da tarefa assíncrona. Você deve usar esse task_id para solicitar a API de consulta de resultado da tarefa para obter o resultado gerado