API de geração de vídeo
Visão geral da API de geração de vídeo com IA da LMU AI: escolha entre Seedance e Wan, além das regras comuns de autenticação, tarefas assíncronas, cobrança, limites de concorrência e códigos de erro.
A LMU AI oferece dois tipos de API de geração de vídeo assíncronas, ambas usando os protocolos nativos dos fornecedores: substitua o endereço no SDK oficial ou no comando curl pelo endereço da LMU AI e a chave pela sua chave de API da LMU AI; o corpo da requisição permanece inalterado. Esta página é a visão geral: escolha uma API na tabela abaixo e depois leia a página do respectivo provedor. As regras comuns aos dois provedores (autenticação, cobrança, limites de concorrência e códigos de erro) estão nesta página.
URL base
https://api.lmuai.com| Provedor | Criar tarefa | Consultar tarefa | Documentação |
|---|---|---|---|
| Seedance (Volcengine Ark) | POST /api/v3/contents/generations/tasks | GET /api/v3/contents/generations/tasks/{id} | API de geração de vídeo Seedance |
| Wan (Alibaba DashScope) | POST /api/v1/services/aigc/video-generation/video-synthesis | GET /api/v1/tasks/{task_id} | API de geração de vídeo Wan |
A geração de vídeo precisa estar habilitada para o seu grupo
O grupo da chave de API precisa ter a "Geração de vídeo" habilitada; caso contrário, as chamadas retornam 403. Os modelos que você pode realmente chamar dependem da sua chave de API; verifique-os com GET /v1/models.
1. Como escolher entre os dois
| Seedance (Volcengine Ark) | Wan (Alibaba DashScope) | |
|---|---|---|
| Modelo de exemplo | seedance-2.5 | wan3.0-video |
| Cobrança | Por tokens de saída | Por "segundos reais × preço unitário da faixa de resolução" |
| Valores de resolução | 480p / 720p / 1080p (minúsculas) | 480P / 720P / 1080P (maiúsculas), padrão 1080P |
| Status da tarefa | queued → running → succeeded / failed / cancelled | PENDING → RUNNING → SUCCEEDED / FAILED / CANCELED |
| Campo da URL do vídeo | content.video_url | output.video_url |
| Cancelamento de tarefa | Tarefas na fila (queued) podem ser canceladas | Não há endpoint de cancelamento; uma tarefa enviada sempre é executada até o fim |
O nome do modelo deve corresponder exatamente ao nome habilitado para o seu grupo (diferencia maiúsculas de minúsculas). As duas APIs usam nomes de campos parecidos, mas com capitalização e caminhos diferentes; não os confunda ao copiar exemplos.
2. Autenticação
Envie sua chave de API no cabeçalho de cada requisição:
Authorization: Bearer YOUR_API_KEYNão coloque sua chave de API em código de front-end no navegador, repositórios públicos, query strings de URL ou logs. Chame a API a partir do seu próprio servidor.
3. Fluxo de tarefas assíncronas
- Criar: o
POSTretorna apenas um id de tarefa; ele não espera pelo vídeo. - Consultar: faça
GETna tarefa a cada 10 segundos, aproximadamente, até que ela atinja um estado final (sucesso / falha / cancelada). - Imagens de referência: as chamadas de API devem passar uma URL de imagem publicamente acessível (JPG / PNG / WebP); a página Geração de vídeo do console aceita upload de imagens locais.
- Download: em caso de sucesso, obtenha o link do vídeo na resposta. Os links do provedor upstream são válidos por 24 horas, então faça o download o quanto antes; a plataforma guarda uma cópia de cada vídeo concluído, que você pode reproduzir e baixar na página Tarefas de vídeo do console.
A cobrança é liquidada mesmo que você pare de consultar
Após o envio, a plataforma acompanha a tarefa em segundo plano e a liquida normalmente, mesmo que você pare de consultá-la; tarefas com falha ou canceladas não são cobradas.
Para exemplos completos de criação e consulta, veja as páginas Seedance e Wan.
4. Cobrança e marcas d'água
- Um valor estimado é congelado quando a tarefa é criada. Se o seu saldo for insuficiente, a requisição é rejeitada imediatamente (
402) e nenhum vídeo é gerado. - Em caso de sucesso, a tarefa é liquidada uma única vez conforme o uso real, e qualquer valor congelado em excesso é devolvido automaticamente; tarefas com falha ou canceladas são reembolsadas integralmente e não são cobradas.
- O Seedance é cobrado por tokens de saída; o Wan é cobrado por "segundos reais × preço unitário da faixa de resolução".
- Os vídeos concluídos trazem o selo "Gerado por IA" da plataforma, que não pode ser desativado pelos clientes.
5. Limites de concorrência
Cada usuário e cada chave de API podem ter no máximo 5 tarefas em geração ao mesmo tempo. Acima disso, as requisições retornam 429 com um cabeçalho Retry-After (cerca de 60 segundos); aguarde e tente novamente.
6. Códigos de erro
| HTTP | Significado | O que fazer |
|---|---|---|
401 | A chave de API é inválida ou está desativada | Verifique sua chave de API |
402 | Saldo ou cota insuficiente para congelar o valor estimado | Recarregue e tente novamente |
403 | A geração de vídeo não está habilitada para o grupo, ou o modelo não está disponível no grupo | Use uma chave de API que ofereça suporte à geração de vídeo |
404 model_not_found | O modelo ainda não está disponível (um nome digitado incorretamente também causa isso) | Use o nome exato retornado por GET /v1/models |
409 | A tarefa já começou a ser gerada e não pode ser cancelada (endpoint de cancelamento do Seedance) | Aguarde a conclusão da tarefa |
429 | O número de tarefas em andamento atingiu o limite | Aguarde conforme o Retry-After e tente novamente |
Para erros gerais, consulte Códigos de erro.
7. Páginas dos provedores
- API de geração de vídeo Seedance: criar, consultar, listar e cancelar tarefas, com parâmetros, observações sobre imagens de referência de primeiro quadro e um exemplo completo de consulta periódica.
- API de geração de vídeo Wan: criar e consultar tarefas, com parâmetros e um exemplo completo de consulta periódica.
Última atualização:
Obtenha uma chave de API da LMU AI e comece a usar Claude, Codex e muito mais
Cadastro gratuito e planos flexíveis. Uma única chave de API para Claude Code, Codex CLI, Cursor, extensão do VS Code, OpenCode, Cherry Studio e outras ferramentas de IA.
Cadastrar-seGemini Batch Image API
API de imagem em lote assíncrona da LMU AI: envie muitas tarefas de imagem Gemini de uma só vez, consulte status e detalhes, baixe imagens ou ZIP, com idempotência e estimativas de custo.
API de geração de vídeo Seedance
Chame a geração de vídeo Seedance (Volcengine Ark) pela LMU AI com o protocolo assíncrono nativo: crie, consulte, liste e cancele tarefas, além de um exemplo completo de polling.