Pular para o conteúdo principal
POST
/
v3
/
async
/
vidu-q3-turbo-t2v
Vidu Q3 Turbo Texto para vídeo
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q3-turbo-t2v \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "seed": 123,
  "audio": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "duration": 123,
  "off_peak": true,
  "watermark": true,
  "resolution": "<string>",
  "wm_position": 123,
  "aspect_ratio": "<string>"
}
'
{
  "task_id": "<string>"
}
O Vidu Q3 Turbo Texto para vídeo pode gerar vídeos de alta qualidade com áudio sincronizado a partir de descrições em texto, com suporte a resolução de até 1080p e duração de 1 a 16 segundos.
Esta é uma API assíncrona e retorna 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
Valores enumerados: application/json
​
Authorization
string
obrigatório
Formato de autenticação Bearer: Bearer {{API Key}}.

​
Corpo da requisição

​
seed
integer
Semente aleatória, usada para resultados reproduzíveis. Quando não informada ou definida como 0, um número aleatório é usado.Faixa de valores: [0, 2147483647]
​
audio
boolean
padrão:true
Define se a capacidade de saída direta de áudio e vídeo será usada (incluindo falas e efeitos sonoros). false: gera vídeo sem som; true: gera vídeo com som. Apenas modelos da série Q3 oferecem suporte a esse parâmetro.
​
prompt
string
obrigatório
Descrição textual para a geração do vídeo, com no máximo 5000 caracteres.Limite de comprimento: 0 - 5000
​
wm_url
string
URL da imagem de conteúdo da marca d’água. Quando não informado, a marca d’água padrão é usada (conteúdo gerado por IA).
​
duration
integer
padrão:5
Duração do vídeo (em segundos), com faixa de 1 a 16; o padrão é 5 segundos.Faixa de valores: [1, 16]
​
off_peak
boolean
padrão:false
Modo fora do horário de pico. true: gera o vídeo fora do horário de pico, consumindo menos créditos, com a tarefa gerada em até 48 horas; false: gera o vídeo imediatamente.
​
watermark
boolean
padrão:false
Define se uma marca d’água será adicionada. true: adiciona marca d’água; false: não adiciona marca d’água. Por padrão, não adiciona marca d’água.
​
resolution
string
padrão:"720p"
Resolução do vídeo de saída.Valores opcionais: 540p, 720p, 1080p
​
wm_position
integer
padrão:3
Posição da marca d’água: 1=canto superior esquerdo, 2=canto superior direito, 3=canto inferior direito, 4=canto inferior esquerdo. Padrão: 3 (canto inferior direito).Faixa de valores: [1, 4]
​
aspect_ratio
string
padrão:"16:9"
Proporção do vídeo de saída.Valores opcionais: 16:9, 9:16, 4:3, 3:4, 1:1

​
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.