Pular para o conteúdo principal
POST
/
v3
/
async
/
vidu-q2-pro-fast-startend2video
VIDU Q2 Pro Fast Quadros inicial e final
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-startend2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "seed": 123,
  "images": [
    {}
  ],
  "is_rec": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "duration": 123,
  "off_peak": true,
  "meta_data": "<string>",
  "watermark": true,
  "resolution": "<string>",
  "wm_position": 123,
  "movement_amplitude": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
Gere um vídeo coerente com base em duas imagens de quadro inicial e final (modo rápido). Compatível com as resoluções 720p e 1080p. O modo rápido pode reduzir significativamente o tempo de geração, sendo adequado para cenários com alta exigência de velocidade.
Esta é uma API assíncrona, que 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 gerado.

​
Cabeçalhos da requisição

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

​
Corpo da requisição

​
bgm
boolean
padrão:false
Indica se deve adicionar música de fundo ao vídeo gerado. true: o sistema selecionará automaticamente uma música adequada da biblioteca de BGM predefinida e a adicionará; false: não adiciona BGM. O BGM não tem limite de duração; o sistema o adapta automaticamente de acordo com a duração do vídeo.
​
seed
integer
Semente aleatória. Quando não for enviada por padrão ou quando for enviado 0, um número aleatório será usado como substituto; se definida manualmente, a semente configurada será usada.
​
images
array
obrigatório
Array de imagens. A primeira imagem é considerada o quadro inicial, e a segunda imagem é considerada o quadro final; o modelo usará as imagens enviadas neste parâmetro para gerar o vídeo. Suporta a entrada de duas imagens. Observação 1: as resoluções das duas imagens de entrada dos quadros inicial e final devem ser semelhantes; a resolução da imagem do quadro inicial / a resolução da imagem do quadro final deve estar entre 0.8 e 1.25; Observação 2: suporta o envio de imagens em codificação Base64 ou URL de imagem (certifique-se de que seja acessível); Observação 3: as imagens aceitas incluem os formatos png, jpeg, jpg e webp; Observação 4: o tamanho da imagem não deve exceder 50M; Observação 5: a codificação Base64 deve incluir a string de tipo de conteúdo apropriada, por exemplo: data:image/png;base64,Comprimento do array: 2 - 2
​
is_rec
boolean
padrão:false
Indica se deve usar prompts recomendados. true: sim, o sistema recomendará automaticamente um prompt e usará o conteúdo dele para gerar o vídeo (cada tarefa consome 10 créditos adicionais); false: não, o vídeo será gerado com base no prompt inserido
​
prompt
string
Prompt de texto, descrição textual para gerar o vídeo. Observação 1: o comprimento não pode exceder 2000 caracteres; Observação 2: se o parâmetro de prompt recomendado is_rec for usado, o modelo não considerará o prompt inserido neste parâmetroLimite de comprimento: 0 - 2000
​
wm_url
string
Conteúdo da marca d’água; aqui, uma URL de imagem. Se não for enviado, a marca d’água padrão será usada: conteúdo gerado por IA
​
payload
string
Parâmetro de passagem direta, sem qualquer processamento, apenas para transmissão de dados. No máximo 1048576 caracteres.Limite de comprimento: 0 - 1048576
​
duration
integer
padrão:5
Duração do vídeo (em segundos), aceita de 1 a 8 segundosValores opcionais: 1, 2, 3, 4, 5, 6, 7, 8
​
off_peak
boolean
padrão:false
Modo fora do horário de pico. true: gera o vídeo fora do horário de pico (consome menos créditos, gerado em até 48 horas); false: gera o vídeo imediatamente. Observação: tarefas enviadas no modo fora do horário de pico que não forem concluídas serão canceladas automaticamente e os créditos serão reembolsados; você também pode cancelar manualmente tarefas fora do horário de pico.
​
meta_data
string
Identificador de metadados, string em formato json, campo de passagem direta; você pode personalizar o formato ou usar o formato de exemplo. Quando este parâmetro estiver vazio, o identificador de metadados gerado pelo vidu será usado por padrão.
​
watermark
boolean
padrão:false
Indica se deve adicionar marca d’água. Por padrão, nenhuma marca d’água é adicionada. Você pode obter o conteúdo do vídeo com marca d’água consultando o parâmetro watermarked_url.
​
resolution
string
padrão:"720p"
Resolução do vídeo de saída. Compatível com 720p e 1080p. O valor padrão é 720p.Valores opcionais: 720p, 1080p
​
wm_position
integer
padrão:3
Posição da marca d’água, indicando onde a marca d’água aparece na imagem. 1: canto superior esquerdo; 2: canto superior direito; 3: canto inferior direito (padrão); 4: canto inferior esquerdoValores opcionais: 1, 2, 3, 4
​
movement_amplitude
string
padrão:"auto"
Amplitude de movimento, controla a intensidade do movimento dos objetos no vídeoValores opcionais: auto, small, medium, large

​
Informações da resposta

​
task_id
string
obrigatório
Use o task_id para solicitar a API de consulta de resultado da tarefa e recuperar a saída gerada.
​
provider_request_id
string
ID da solicitação do provedor (opcional)