Primeiros passos
A API DeepManim permite gerar vídeos educativos animados por programação. Crie vídeos a partir de prompts de texto, melhore-os iterativamente e adicione narração — tudo por meio de uma API REST simples.
URL base: https://api.deepmanim.com/api/v1
Observações importantes
- Áudio na geração: Ao gerar um vídeo novo via /generate, a narração em áudio é incluída por padrão.
- Sem áudio nas modificações: Ao melhorar um vídeo via /improve, o resultado não inclui áudio. Termine todas as modificações primeiro e adicione o áudio via /audio quando estiver satisfeito com o vídeo.
- Tempos estimados: A geração de vídeo leva aproximadamente 6 minutos. O campo estimated_time_remaining_seconds na resposta do job mostra uma contagem regressiva ao vivo.
Autenticação
Todas as requisições da API exigem uma chave de API. Crie uma em Configurações → Chaves de API no aplicativo.
É necessário comprar créditos. O acesso à API está disponível para usuários que compraram créditos pelo menos uma vez. Apenas os créditos do plano gratuito não são suficientes.
Inclua sua chave no cabeçalho Authorization:
Authorization: Bearer dm_k_your_api_key_here
Mantenha sua chave de API em segredo. Não a compartilhe em repositórios públicos ou aplicações do lado do cliente.
Início rápido
Gere um vídeo em três etapas: crie um job, consulte a conclusão e recupere o resultado.
1. Gerar um vídeo
curl -X POST https://api.deepmanim.com/api/v1/generate \
-H "Authorization: Bearer dm_k_your_key" \
-H "Content-Type: application/json" \
-d '{"message": "Explique como funciona a fotossíntese", "preferred_locale": "pt-BR"}'2. Consultar a conclusão
curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \ -H "Authorization: Bearer dm_k_your_key" # A resposta inclui: # status: "pending" | "running" | "completed" | "failed" # phase: "exploring_ideas" | "brainstorming" | "crafting_vision" | "refining_details" | "assembling_pieces" | "polishing" | "adding_voice" | "iterating" | "done" # estimated_time_remaining_seconds: 285
3. Obter o resultado
# Quando o status for "completed", a resposta incluirá:
{
"job_id": "...",
"status": "completed",
"phase": "done",
"estimated_time_remaining_seconds": 0,
"result": {
"video_url": "https://...",
"description": "Uma animação explicando a fotossíntese...",
"session_id": "...",
"message_id": "...",
"duration_seconds": 24.6,
"has_audio": true,
"follow_up": "Como a respiração celular se relaciona com a fotossíntese?"
}
}Endpoints
Geração de vídeo
Jobs
Sessões
Mensagens
Conta
Créditos e preços
Cada chamada da API que cria um job desconta créditos do seu saldo:
| Operação | Custo |
|---|---|
| Gerar vídeo | A partir de 1,5 créditos |
| Melhorar vídeo | A partir de 1,5 créditos |
| Adicionar áudio | 1 crédito |
| Melhorar narração | 1 crédito |
Os custos de geração e melhoria dependem do preset selecionado e atualmente variam de 1,5 a 70 créditos. Ler sessões, mensagens, status de jobs e informações da conta é gratuito e não desconta créditos.
Respostas de erro
| Status | Significado |
|---|---|
| 401 | Chave de API ausente ou inválida |
| 402 | Créditos insuficientes |
| 404 | Recurso não encontrado (sessão, mensagem ou job) |
| 400 | Requisição inválida (por exemplo, nenhum vídeo para melhorar ou nenhuma narração para refinar) |