Pular para o conteúdo principal
POST
/
v3
/
async
/
vidu-q2-turbo-startend2video
VIDU Q2 Turbo Quadros Inicial e Final
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-turbo-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 rapidamente um vídeo coerente a partir de imagens dos quadros inicial e final. Suporta três resoluções: 540p, 720p e 1080p. A versão Turbo equilibra velocidade de geração e qualidade de vídeo.
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 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
Define se uma música de fundo será adicionada 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 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 for enviada como 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 é tratada como o quadro inicial, e a segunda imagem é tratada como o quadro final; o modelo gerará o vídeo usando as imagens passadas neste parâmetro. 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 / resolução da imagem do quadro final deve estar entre 0.8 e 1.25; Observação 2: suporta o envio de imagens codificadas em Base64 ou URL de imagem (certifique-se de que esteja acessível); Observação 3: as imagens suportam 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
Define se serão usados prompts recomendados. true: sim, o sistema recomendará automaticamente prompts e usará o conteúdo dos prompts para gerar o vídeo (cada tarefa consome 10 créditos adicionais); false: não, o vídeo será gerado com base no prompt de entrada.
​
prompt
string
Prompt de texto, a 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âmetro.Limite de comprimento: 0 - 2000
​
wm_url
string
Conteúdo da marca d’água; aqui, é uma URL de imagem. Se não for enviado, será usada a marca d’água padrão: 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 (segundos), suporta 1-8 segundosValores opcionais: 1, 2, 3, 4, 5, 6, 7, 8
​
off_peak
boolean
padrão:false
Modo fora de pico. true: gera vídeos fora de pico (consome menos créditos, gerados em até 48 horas); false: gera vídeos imediatamente. Observação: tarefas enviadas no modo fora de pico que não forem concluídas serão automaticamente canceladas e os créditos serão reembolsados; você também pode cancelar manualmente tarefas fora de pico.
​
meta_data
string
Identificador de metadados, string em formato json, campo de passagem direta. Você pode definir um formato personalizado 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
Define se uma marca d’água será adicionada. Por padrão, não adiciona marca d’água. 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. O valor padrão é 720p.Valores opcionais: 540p, 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)