Saltar para o conteúdo principal

Visão Geral

A LemonData fornece acesso a mais de 69 modelos de geração de vídeo de 11 provedores por meio de uma única API unificada. A geração de vídeo é assíncrona — você envia uma solicitação e recebe um ID de tarefa (task ID) e, em seguida, realiza a consulta (poll) pelo resultado.
A lista de modelos é atualizada frequentemente. Para os modelos e preços mais recentes disponíveis, visite a Models page ou use a Models API.

Fluxo de Trabalho Assíncrono

import requests
import time

API_KEY = "sk-your-api-key"
BASE = "https://api.lemondata.cc/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# Passo 1: Enviar solicitação de geração
resp = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "kling-v2.6-pro",
        "prompt": "A golden retriever running on a beach at sunset, cinematic 4K",
        "duration": 5,
        "aspect_ratio": "16:9"
    }
)
task_id = resp.json()["task_id"]

# Passo 2: Consultar o resultado
while True:
    status = requests.get(f"{BASE}/videos/generations/{task_id}", headers=headers).json()
    if status["status"] in ("completed", "succeeded"):
        print(f"Video URL: {status['video_url']}")
        break
    elif status["status"] == "failed":
        print(f"Failed: {status.get('error')}")
        break
    time.sleep(10)

Matriz de Capacidades dos Modelos

Diferentes modelos se destacam em diferentes tarefas. Use esta matriz para escolher o modelo certo para o seu caso de uso. Legenda: ✅ Suportado | ❌ Não suportado
SérieProvedorT2VI2VKeyframeExtensãoEdiçãoDuração Máxima
SoraOpenAI~20s
KlingKuaishou10s
VeoGoogle8s
SeedanceByteDance10s
HailuoMiniMax6s
WanAlibaba5s
RunwayRunway10s
LumaLuma5s
ViduVidu8s
GrokxAI~10s
HiggsfieldHiggsfield~5s

Definições de Capacidades

  • T2V (Text-to-Video): Gerar vídeo a partir de um prompt de texto
  • I2V (Image-to-Video): Animar uma imagem estática em vídeo usando image_url ou image
  • Keyframe: Controlar os quadros inicial e final com start_image + end_image
  • Extensão: Estender a duração de um vídeo existente
  • Edição: Modificar aspectos específicos de um vídeo existente

Modelos Disponíveis por Série

Sora (OpenAI)

ModeloQualidadeNotas
sora-2PadrãoModelo padrão, bom equilíbrio entre qualidade e velocidade
sora-2-proAltaQualidade superior, tempo de geração mais longo
sora-2-charactersPadrãoGeração focada em personagens

Kling (Kuaishou)

ModeloCapacidadeNotas
kling-v2.6-proT2VGeração mais recente, qualidade profissional
kling-v2.6-stdT2VGeração mais recente, rápido
kling-v2.5-turbo-proT2VVelocidade turbo, qualidade pro
kling-v2.1-masterT2V/I2VQualidade master
kling-v2.1-proT2V/I2VQualidade profissional
kling-v2.1-standardT2V/I2VQualidade padrão
kling-videoT2V/I2VModelo base
kling-video-extendExtensãoEstender vídeos existentes
kling-video-o1-proT2VRaciocínio O1, qualidade pro
kling-video-o1-stdT2VRaciocínio O1, padrão
kling-effectsEfeitosAplicar efeitos visuais
kling-omni-videoT2VModelo Omni
kling-motion-controlT2VGeração com controle de movimento

Veo (Google)

ModeloQualidadeNotas
veo3.1PadrãoModelo de vídeo mais recente do Google
veo3.1-proAltaQualidade profissional
veo3.1-4kUltraSaída em resolução 4K
veo3.1-fastRápidoGeração mais rápida
veo3.1-fast-4kRápido + 4KGeração rápida com saída em 4K
veo3.1-componentsPadrãoGeração baseada em componentes
veo3PadrãoGeração anterior
veo3-proAltaGeração anterior, profissional
veo3-fastRápidoGeração anterior, rápida

Seedance (ByteDance)

ModeloCapacidadeNotas
seedance-2-0T2V/I2V/Keyframe/Extensão/EdiçãoMais recente, mais capaz
seedance-1-5-proT2V/I2VGeração anterior, qualidade pro
seedance-1-0-proT2V/I2VPrimeira geração, pro
seedance-1-0-pro-fastT2V/I2VPrimeira geração, rápida
seedance-1-0-lite-t2vT2VText-to-video leve
seedance-1-0-lite-i2vI2VImage-to-video leve
O Seedance 2.0 suporta a mais ampla gama de capacidades, incluindo multimodal-to-video, extensão de vídeo e edição de vídeo — tudo através do mesmo endpoint de API.

Hailuo (MiniMax)

ModeloQualidadeNotas
hailuo-2.3PadrãoBoa qualidade
hailuo-2.3-proAltaSaída de qualidade superior
hailuo-2.3-fastRápidoGeração mais rápida
hailuo-2.3-standardPadrãoNível padrão
video-01PadrãoMiniMax video-01
video-01-livePadrãoGeração em estilo live

Wan (Alibaba)

ModeloCapacidadeNotas
wan-2.6T2VText-to-video mais recente
wan2.6-i2vI2VImage-to-video mais recente
wan-2.5T2VGeração anterior
wan2.5-i2v-previewI2VI2V da geração anterior
wan-2.2-plusT2VGeração mais antiga
vace-14bT2VArquitetura VACE

Runway

ModeloDuraçãoNotas
runwayml-gen4-turbo-55sGeração rápida
runwayml-gen4-turbo-1010sClipes mais longos

Luma

ModeloCapacidadeNotas
luma-video-apiT2VText-to-video
luma-video-extend-apiExtensãoEstender vídeos existentes

Vidu (Shengshu)

ModeloQualidadeNotas
viduq3-proAltaGeração mais recente
viduq2-proAltaGeração anterior, pro
viduq2-pro-fastRápidoGeração anterior, pro rápida
viduq2PadrãoGeração anterior, padrão
viduq2-turboRápidoVelocidade turbo
vidu2.0PadrãoModelo base

Grok (xAI)

ModeloNotas
grok-video-3Modelo de geração de vídeo da xAI
grok-video-3-10sVariante de 10 segundos

Higgsfield

ModeloNotas
higgsfield-turboMais rápido, custo menor
higgsfield-standardQualidade padrão
higgsfield-liteVersão leve

Exemplos de Uso

Text-to-Video (T2V)

O caso de uso mais comum. Todos os modelos suportam isso.
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "veo3.1-pro",
        "prompt": "Aerial drone shot of a coastal city at golden hour, waves crashing against cliffs",
        "duration": 5,
        "aspect_ratio": "16:9",
        "resolution": "1080p"
    }
)

Image-to-Video (I2V)

Animar uma imagem estática. Use image_url para uma URL ou image para dados em base64.
# Usando URL da imagem
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "wan2.6-i2v",
        "prompt": "The person slowly turns and smiles at the camera",
        "image_url": "https://example.com/portrait.jpg"
    }
)

# Usando imagem em base64
import base64
with open("photo.jpg", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "kling-v2.1-master",
        "prompt": "Gentle wind blows through the scene",
        "image": f"data:image/jpeg;base64,{image_b64}"
    }
)

Controle de Keyframe (Imagem Inicial + Final)

Controle tanto o primeiro quanto o último quadro para transições precisas. Atualmente suportado pelo Seedance 2.0.
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "seedance-2-0",
        "prompt": "Smooth transition from day to night, city lights gradually turning on",
        "start_image": "https://example.com/city-day.jpg",
        "end_image": "https://example.com/city-night.jpg",
        "duration": 5
    }
)

Extensão de Vídeo

Estender a duração de um vídeo existente. Use modelos com capacidade de extensão.
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "kling-video-extend",
        "prompt": "Continue the scene naturally",
        "image_url": "https://example.com/last-frame.jpg"
    }
)

Referência de Parâmetros

ParâmetroTipoDescrição
modelstringID do modelo (padrão: sora-2)
promptstringObrigatório. Descrição em texto do vídeo
image_urlstringURL da imagem inicial (para I2V)
imagestringImagem codificada em base64 com prefixo de URL de dados (para I2V)
durationintegerDuração do vídeo em segundos (1-60, dependente do modelo)
aspect_ratiostring16:9, 9:16, 1:1, etc.
resolutionstring1080p, 720p, 4k
fpsintegerQuadros por segundo (1-120)
negative_promptstringO que evitar na geração
seedintegerSemente aleatória para reprodutibilidade
cfg_scalenumberEscala de orientação (0-20)
motion_strengthnumberIntensidade do movimento (0-1)
start_imagestringURL do keyframe inicial
end_imagestringURL do keyframe final
Nem todos os parâmetros são suportados por todos os modelos. Parâmetros não suportados são ignorados silenciosamente. Verifique a documentação do modelo para os parâmetros suportados.

Guia de Seleção de Modelo

Melhor Qualidade

Seedance 2.0 ou Kling v2.6 Pro — qualidade cinematográfica, detalhes ricos, movimento natural

Geração Mais Rápida

Higgsfield Turbo ou Hailuo 2.3 — resultados rápidos para prototipagem e iteração

Mais Versátil

Seedance 2.0 — suporta T2V, I2V, keyframe, extensão e edição em um único modelo

Melhor Custo-benefício

Wan 2.6 ou Hailuo 2.3 — qualidade competitiva a um custo menor por geração

Faturamento

A geração de vídeo utiliza um preço fixo por geração. Você é cobrado uma vez quando a tarefa é enviada, independentemente da duração do vídeo. Se a geração falhar, a cobrança é reembolsada automaticamente. Verifique os preços atuais na Models page ou através da Pricing API.