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": "wan2.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "Replace the background with a snowy mountain scene",
    "resolution": "1080P"
  }'

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

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": "wan2.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "Replace the background with a snowy mountain scene",
    "resolution": "1080P"
  }'

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

​
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 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ídeo, fixo como wan2.7-videoedit
​
video_urls
array<string>
obrigatório
Array de URLs de vídeo de origem para edição
Apenas o 1º vídeo é usado
Restrições do vídeo:
  • Formato: mp4, mov
  • Duração: 2–10s
  • Resolução: largura e altura no intervalo [240, 4096] pixels
  • Proporção: 1:8 – 8:1
  • Tamanho do arquivo: até 100MB
​
prompt
string
Instrução de edição descrevendo as alterações desejadas, até 5000 caracteres
Se omitido, o modelo executa uma transferência de estilo padrão
Exemplo: "Change the character's outfit to a red gown", "Replace the background with a snowy mountain scene"
​
negative_prompt
string
Prompt negativo que descreve conteúdo indesejado, até 500 caracteres
​
image_urls
array<string>
Array de URLs de imagens de referência, até 4 imagensUsado para especificar o estilo ou a aparência desejados (por exemplo, estilo de referência para transferência de estilo)
​
resolution
string
padrão:"1080P"
Resolução do vídeo de saídaOpções:
  • 720P - Padrão
  • 1080P - Alta definição (padrão)
​
duration
integer
padrão:"0"
Duração do vídeo de saída (segundos)
  • 0 (padrão): mantém a duração completa do vídeo original
  • Inteiro entre 2-10: pega a duração especificada a partir do início
Quando duration=0, a cobrança é baseada na duração real do vídeo de saídaA duração especificada não pode exceder a duração do vídeo original em video_urls
​
size
string
Proporção de saídaFormatos suportados:
  • 16:9 - Paisagem widescreen
  • 9:16 - Retrato
  • 1:1 - Quadrado
  • 4:3 - Paisagem
  • 3:4 - Retrato
Se omitido, a proporção corresponde ao vídeo de entrada
​
prompt_extend
boolean
padrão:"true"
Se deve ativar a reescrita inteligente do promptMelhora significativamente os resultados para prompts curtos, mas aumenta o tempo de processamentoPadrão: true
​
watermark
boolean
padrão:"false"
Se deve adicionar a marca d’água “AI Generated” ao vídeo gerado
  • true: adicionar marca d’água
  • false: sem marca d’água (padrão)
​
seed
integer
Inteiro de seed usado para controlar a aleatoriedade do conteúdo geradoIntervalo de valores: inteiro ≥0
  • Para requisições idênticas, o modelo gera resultados diferentes ao receber valores de seed diferentes (por exemplo, omitindo o seed)
  • Para requisições idênticas, o modelo gera resultados semelhantes ao receber o mesmo valor de seed, mas a consistência exata não é garantida
​
metadata
object
Objeto de parâmetros adicionais

​
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: Edição básica de vídeo (Mais simples)

{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "prompt": "Replace the background with a snowy mountain scene"
}

​
Caso 2: Transferência de estilo (com imagem de referência)

{
  "model": "wan2.7-videoedit",
  "prompt": "Transfer the video style to the anime style of the reference image",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": [
    "https://cdn.example.com/anime_style.jpg"
  ],
  "resolution": "1080P",
  "watermark": false
}

​
Caso 3: Manter o áudio original do vídeo

Adequado para vídeos com sons de fundo ou diálogos importantes: 
{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/speech.mp4"],
  "prompt": "Replace the background with a mountain path",
  "metadata": { "audio_setting": "origin" }
}

​
Caso 4: Parâmetros completos

{
  "model": "wan2.7-videoedit",
  "prompt": "Change the character's outfit to a red gown",
  "negative_prompt": "blurry, distorted",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": ["https://cdn.example.com/reference.jpg"],
  "resolution": "1080P",
  "duration": 0,
  "size": "16:9",
  "prompt_extend": true,
  "watermark": false,
  "seed": 888,
  "metadata": {
    "audio_setting": "origin"
  }
}

​
Tratamento de áudio

audio_settingDescriçãoCenários adequados
auto (padrão)A IA regenera áudio correspondente com base no conteúdo do vídeo editadoGrandes mudanças visuais de estilo em que você deseja que o áudio seja atualizado de acordo
originForça a manutenção da faixa de áudio original do vídeoVídeos com música de fundo ou diálogos importantes
Consultar resultados da tarefaA geração de vídeos é uma tarefa assíncrona que retorna um task_id no envio. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.