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-r2v",
    "prompt": "This person walks down the street surrounded by heavy traffic",
    "image_with_roles": [{"url": "https://cdn.example.com/character.jpg", "role": "reference_image"}],
    "resolution": "1080P",
    "duration": 8
  }'

{
  "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-r2v",
    "prompt": "This person walks down the street surrounded by heavy traffic",
    "image_with_roles": [{"url": "https://cdn.example.com/character.jpg", "role": "reference_image"}],
    "resolution": "1080P",
    "duration": 8
  }'

{
  "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-r2v
​
prompt
string
obrigatório
Descrição do conteúdo do vídeo, até 5000 caracteresPara múltiplas imagens/vídeos, use “image 1”, “image 2”, “video 1”, etc. para referenciar os ativos de referência correspondentes (na ordem de entrada)Exemplo: "The character in image 1 enters the scene in image 2 and looks around"
​
image_with_roles
array<object>
Array de imagens com papéis; pelo menos um entre este e video_urls deve ser fornecidoCampos de cada objeto:
  • url (string): URL da imagem
  • role (string): papel da imagem
    • reference_image - imagem de referência (padrão)
    • first_frame - primeiro quadro especificado (quando fornecido, size é ignorado e a proporção segue a imagem do primeiro quadro)
  • reference_voice (string, opcional): URL do áudio de amostra de voz para esse personagem de referência, usado para controlar a voz do personagem no vídeo gerado
Exemplo:
[
  {
    "url": "https://cdn.example.com/character.jpg",
    "role": "reference_image",
    "reference_voice": "https://cdn.example.com/voice_sample.mp3"
  },
  { "url": "https://cdn.example.com/start.jpg", "role": "first_frame" }
]
​
video_urls
array<string>
Array de URLs de vídeos de referência, até 5 vídeos (total de imagens + vídeos ≤ 5)Pelo menos um entre este e image_with_roles deve ser fornecido
Restrições do vídeo:
  • Formato: mp4, mov
  • Duração: 1–30s
  • Resolução: largura e altura no intervalo [240, 4096] pixels
  • Proporção: 1:8 – 8:1
  • Tamanho do arquivo: até 100MB
​
negative_prompt
string
Prompt negativo que descreve conteúdo indesejado, até 500 caracteres
​
resolution
string
padrão:"1080P"
Resolução do vídeoOpções:
  • 720P - Padrão
  • 1080P - Alta definição (padrão)
​
duration
integer
padrão:"5"
Duração do vídeo (segundos)Intervalo suportado: 2 ~ 15 segundosPadrão: 5
Quando os ativos de referência incluem um vídeo: um inteiro entre [2, 10].Quando os ativos de referência não incluem um vídeo: um inteiro entre [2, 15].
​
size
string
padrão:"16:9"
Proporção de telaFormatos suportados:
  • 16:9 - Paisagem widescreen (padrão)
  • 9:16 - Retrato
  • 1:1 - Quadrado
  • 4:3 - Paisagem
  • 3:4 - Retrato
Quando first_frame é fornecido via image_with_roles, este parâmetro é ignorado e a proporção segue a imagem do primeiro quadro
​
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

​
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: Imagem de referência única (Mais simples)

{
  "model": "wan2.7-r2v",
  "prompt": "This person walks down the street surrounded by heavy traffic",
  "image_with_roles": [
    { "url": "https://cdn.example.com/character.jpg", "role": "reference_image" }
  ]
}

​
Caso 2: Múltiplas imagens de referência

{
  "model": "wan2.7-r2v",
  "prompt": "The character in image 1 enters the scene in image 2 and mimics the pose in image 3",
  "image_with_roles": [
    { "url": "https://cdn.example.com/person.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/background.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/pose.jpg", "role": "reference_image" }
  ],
  "resolution": "1080P",
  "duration": 8,
  "size": "16:9"
}

​
Caso 3: Geração com base em vídeo de referência

{
  "model": "wan2.7-r2v",
  "prompt": "Generate a beach sunset scene in the style of the reference video",
  "video_urls": ["https://cdn.example.com/style_reference.mp4"],
  "resolution": "720P",
  "duration": 8
}

​
Caso 4: Primeiro quadro especificado + imagem de referência

{
  "model": "wan2.7-r2v",
  "prompt": "The reference character starts from this position and walks forward",
  "image_with_roles": [
    { "url": "https://cdn.example.com/character.jpg", "role": "reference_image" },
    { "url": "https://cdn.example.com/start.jpg", "role": "first_frame" }
  ],
  "resolution": "1080P",
  "duration": 8
}

​
Caso 5: Imagem de referência + voz de referência (Precisa)

{
  "model": "wan2.7-r2v",
  "prompt": "This person walks down the street while speaking",
  "image_with_roles": [
    {
      "url": "https://cdn.example.com/character.jpg",
      "role": "reference_image",
      "reference_voice": "https://cdn.example.com/voice_sample.mp3"
    }
  ],
  "resolution": "1080P",
  "duration": 10
}

​
Regras de referência de imagens

Com múltiplas imagens de referência, use índices numéricos no prompt para referenciá-las:
  • 1ª imagem → “image 1” ou “the first image”
  • 1º vídeo → “video 1” ou “the first video”
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.