Pular para o conteúdo principal
POST
/
v3
/
async
/
vidu-q2-pro-startend2video
VIDU Q2 Pro quadro inicial e final
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-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 a partir de duas imagens, uma do quadro inicial e outra do quadro final. Compatível com três resoluções: 540p, 720p e 1080p.
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 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

​
bgm
boolean
padrão:false
Define se será adicionada 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 se adapta automaticamente à duração do vídeo.
​
seed
integer
Semente aleatória. Quando não for informada por padrão ou quando for informado 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 passadas neste parâmetro para gerar o vídeo. Observação 1: as resoluções das duas imagens de entrada, quadro inicial e quadro 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: é compatível com a entrada de codificação Base64 da imagem ou URL da imagem (certifique-se de que esteja acessível); Observação 3: as imagens são compatíveis com 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 do prompt 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âmetroLimite de comprimento: 0 - 2000
​
wm_url
string
Conteúdo da marca d’água; aqui, é a URL da imagem. Se não for informado, a marca d’água padrão será usada: conteúdo gerado por IA
​
payload
string
Parâmetro de passagem, 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), compatível com 1-8 segundosValores opcionais: 1, 2, 3, 4, 5, 6, 7, 8
​
off_peak
boolean
padrão:false
Modo fora 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 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 de pico.
​
meta_data
string
Identificador de metadados, string em formato json, campo de passagem; você pode personalizar o formato ou usar o formato de exemplo. Quando este parâmetro estiver vazio, será usado por padrão o identificador de metadados gerado pelo vidu.
​
watermark
boolean
padrão:false
Define se será adicionada marca d’água. Por padrão, não adiciona marca d’água. Você pode consultar e obter o conteúdo do vídeo com marca d’água por meio do 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 do 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 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)