Saltar para o conteúdo principal
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "A cat playing piano, camera slowly zooms in",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "A cat playing piano, camera slowly zooms in",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

​
Autorização

​
Authorization
string
obrigatório
Todos os endpoints da API exigem autenticação via Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione-a ao cabeçalho da requisição:
Authorization: Bearer YOUR_API_KEY

​
Parâmetros da requisição

​
model
string
obrigatório
Nome do modelo de geração de vídeoModelos suportados:
  • viduq3-pro - Vidu Q3 Pro
  • viduq3-turbo - Vidu Q3 Turbo
​
prompt
string
obrigatório
Prompt de texto, máximo de 2000 caracteresObrigatório para text-to-video. Opcional para image-to-video e para o modo de primeiro e último frames.Exemplo: "A cat playing piano, camera slowly zooms in"
​
duration
integer
padrão:"5"
Duração do vídeo (segundos)Faixa: 1 a 16Padrão: 5
​
resolution
string
padrão:"720p"
Resolução do vídeoOpções:
  • 540p - Definição padrão
  • 720p - HD (padrão)
  • 1080p - Full HD
Padrão: 720p
​
aspect_ratio
string
Proporção do vídeo (apenas para o modo text-to-video)Opções:
  • 16:9 - Paisagem
  • 9:16 - Retrato
  • 4:3 - Tradicional
  • 3:4 - Tradicional vertical
  • 1:1 - Quadrado
Este parâmetro está disponível apenas no modo text-to-video (quando image_urls não é fornecido).
​
image_urls
array<url>
Array de URLs de imagens para geração image-to-videoO sistema determina automaticamente o modo de geração com base na quantidade de imagens:
  • 0 imagens (não fornecido): Modo text-to-video
  • 1 imagem: Modo image-to-video (imagem usada como frame inicial)
  • 2 imagens: Modo primeiro e último frames (a primeira imagem é o primeiro frame, a segunda é o último frame)
Exemplo: ["https://example.com/photo.jpg"]
  • Suporta no máximo 2 imagens
  • Para o modo primeiro e último frames, exatamente 2 imagens devem ser fornecidas
  • Quando image_urls é fornecido (seja 1 ou 2 imagens), o parâmetro aspect_ratio não pode ser usado — a proporção do vídeo será determinada automaticamente pela imagem
​
audio
boolean
padrão:"true"
Define se o áudio deve ser gerado (diálogos, efeitos sonoros)Padrão: trueDefina como false se precisar de um vídeo silencioso.
​
seed
integer
Seed inteiro para controlar a aleatoriedade do conteúdo geradoIntervalo: inteiro entre -1 e 2^32-1
  • Com a mesma solicitação, valores de seed diferentes (incluindo não especificado ou -1, que usa um número aleatório) produzirão resultados diferentes
  • Com a mesma solicitação, o mesmo valor de seed produzirá resultados semelhantes, mas a reprodutibilidade exata não é garantida

​
Roteamento automático

O sistema determina automaticamente o modo de geração com base na quantidade de imagens em image_urls:
Quantidade de imagensModoDescrição
0 (não fornecido)Text-to-VideoGeração apenas a partir da descrição em texto
1Image-to-VideoA imagem é usada como frame inicial
2Primeiro e último framesA primeira imagem é o primeiro frame, a segunda é o último

​
Matriz de suporte de parâmetros

ParâmetroText-to-VideoImage-to-VideoPrimeiro e último frames
model✅ Obrigatório✅ Obrigatório✅ Obrigatório
prompt✅ ObrigatórioOpcionalOpcional
image_urls-✅ 1 imagem✅ 2 imagens
duration✅ 1-16s✅ 1-16s✅ 1-16s
resolution✅✅✅
aspect_ratio✅--
audio✅✅✅
seed✅✅✅

​
Resposta

​
code
integer
Código de status da resposta, 200 em caso de sucesso
​
data
array
Array de dados da resposta

​
Casos de uso

​
Caso 1: Texto para vídeo

{
  "model": "viduq3-pro",
  "prompt": "A cat playing piano, camera slowly zooms in",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

​
Caso 2: Imagem para vídeo (imagem única)

{
  "model": "viduq3-pro",
  "prompt": "The person slowly turns and smiles",
  "image_urls": ["https://example.com/photo.jpg"],
  "duration": 5,
  "resolution": "720p"
}

​
Caso 3: Vídeo por primeiro e último frame

{
  "model": "viduq3-pro",
  "prompt": "The person gradually sits down from standing",
  "image_urls": [
    "https://example.com/first.jpg",
    "https://example.com/last.jpg"
  ],
  "duration": 8
}

​
Caso 4: Vídeo silencioso (áudio desativado)

{
  "model": "viduq3-pro",
  "prompt": "Sunset seascape timelapse photography",
  "duration": 10,
  "resolution": "1080p",
  "audio": false
}
Consultar os resultados da tarefaA geração de vídeo é uma tarefa assíncrona que retorna um task_id ao ser submetida. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.