Pular para o conteúdo principal
POST
/
v3
/
async
/
vidu-q1-reference2video
Vidu Q1 Vídeo por referência
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q1-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 Q1 Vídeo por 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 múltiplos ângulos do sujeito, você pode criar vídeos mantendo 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 para recuperar o resultado da geração do vídeo.

​
Cabeçalhos da solicitação

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

​
Corpo da solicitação

​
images
string[]
obrigatório
O modelo usará as imagens fornecidas como referência para gerar um vídeo com sujeito consistente.Requisitos do campo de imagem:
  • Aceita de 1 a 7 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 do vídeo, com comprimento máximo de 1500 caracteres.
​
duration
integer
Duração do vídeo (em segundos). O padrão é 5 segundos; atualmente, apenas a opção 5 segundos é suportada.
​
seed
integer
Semente aleatória para 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 opcionais: 16:9, 9:16, 1:1
​
resolution
string
Resolução do vídeo de saída. O padrão é 1080p; atualmente, apenas a opção 1080p é suportada.
​
movement_amplitude
string
Amplitude de movimento dos objetos na imagem. Valor padrão: auto
Valores opcionais: auto, small, medium, large
​
bgm
boolean
Se deve adicionar música de fundo ao vídeo gerado. Valor padrão: false
Valores opcionais: 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