PopNowAPI
Pegue sua chave de API

daVinci-MagiHuman API

da Sand.ai

Coloque uma fala entre aspas e a pessoa na tela a diz

sand-ai/davinci-magihuman/text-to-video
  • Até 1080p
  • Clipes de 5 a 10 s
  • Criar vídeo
  • Imagem para vídeo

Sobre o daVinci-MagiHuman

O daVinci-MagiHuman, um modelo aberto da Sand.ai e da SII-GAIR, gera imagem e voz juntas: coloque uma fala entre aspas e a pessoa na tela a diz. Ele cria clipes de 5 a 10 segundos a partir de um prompt ou de uma foto inicial, em 256p, 720p ou 1080p, em 16:9 ou 9:16.

Chame com o nome de modelo sand-ai/davinci-magihuman/text-to-video em POST /jobs/createTask, a partir de US$ 0,12.

Por enquanto este guia está só em inglês. →

Parâmetros da requisição

ParâmetroObrigatórioDescrição
aspect_ratioNãoO formato do quadro: horizontal, quadrado ou vertical. 16:9 · 9:16 · Padrão: 16:9
duration_secondsNãoQuanto tempo dura o clipe. Cobrado por segundo. ≥ 5 · ≤ 10 · Padrão: 5
promptSimWhat happens, and in quotes what the person says. The model speaks quoted lines itself.
resolutionNãoTamanho de saída. Maior fica mais nítido e custa mais. 256p · 720p · 1080p · Padrão: 720p
seedNãoRepetir o mesmo número dá um resultado reproduzível. ≥ 0 · ≤ 2147483647

Preços

Os preços são em USD. A API usa um saldo separado em dólares americanos. Os créditos do site não podem ser usados na API nem convertidos em saldo de API, e o saldo de API não pode ser convertido em créditos do site. Ao aceitar uma tarefa, reservamos o valor máximo do orçamento no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.

OpçãoUSD por segundo
resolution 256pUS$ 0,024
resolution 720pUS$ 0,048
resolution 1080pUS$ 0,072

Antes de executar, envie o mesmo corpo de requisição para POST /jobs/quote para ver o custo estimado e o máximo em USD. O orçamento não executa tarefas nem debita seu saldo.

Início rápido da API

Chame a API do daVinci-MagiHuman em três passos

  1. Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow-. As chamadas usam seu saldo separado em dólares americanos.
  2. Envie a requisição. Faça POST /jobs/createTask com model sand-ai/davinci-magihuman/text-to-video e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
  3. Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "sand-ai/davinci-magihuman/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.

Perguntas sobre a API do daVinci-MagiHuman

Quanto custa a API do daVinci-MagiHuman?

O daVinci-MagiHuman custa a partir de US$ 0,12 por um clipe de 5 segundos com Criar vídeo, a tarefa mais barata. Preços por opção: 256p US$ 0,024 por segundo, 720p US$ 0,048 por segundo, 1080p US$ 0,072 por segundo. A API usa um saldo separado em dólares americanos. Os créditos do site não podem ser usados na API nem convertidos em saldo de API, e o saldo de API não pode ser convertido em créditos do site. Ao aceitar uma tarefa, reservamos o valor máximo do orçamento no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.

Qual é o nome de modelo do daVinci-MagiHuman na API?

Coloque sand-ai/davinci-magihuman/text-to-video para Criar vídeo; sand-ai/davinci-magihuman/image-to-video para Imagem para vídeo no campo model de POST /jobs/createTask.

O que é o daVinci-MagiHuman?

Um modelo de 15 bilhões de parâmetros da Sand.ai em conjunto com a SII-GAIR, lançado com pesos abertos sob Apache 2.0; o artigo foi publicado em 23 de março de 2026. Ele gera vídeo e áudio juntos em uma só passagem, então uma única requisição devolve a imagem e a trilha sonora. Foi feito para pessoas falando ou cantando diante da câmera e também cobre cenas gerais.

Em quais idiomas a pessoa pode falar?

O publicador lista chinês (mandarim e cantonês), inglês, japonês, coreano, alemão e francês. Testamos inglês, então confira uma primeira execução em qualquer outro idioma.

Como faço a pessoa dizer algo?

Coloque a fala entre aspas no prompt. O modelo fala sozinho o que está entre aspas. Nas nossas três execuções com fala entre aspas, a transcrição da trilha sonora bateu palavra por palavra com o prompt.

Qual a duração e o tamanho dos clipes?

De 5 a 10 segundos (padrão 5), em 256p, 720p (padrão) ou 1080p, na horizontal 16:9 ou na vertical 9:16. O modelo renderiza em uma resolução base baixa, e a própria etapa de super-resolução gera as faixas mais altas. Nas nossas execuções, 720p em 16:9 saiu com cerca de 1358 x 678, 720p em 9:16 cerca de 726 x 1270 e 1080p em 16:9 cerca de 1904 x 1088, todos a 25 fps.

A mesma seed gera o mesmo clipe?

Uma seed fixa com as mesmas entradas gera resultados parecidos, não garantidamente idênticos. Use-a para comparar execuções enquanto muda uma coisa de cada vez.

Quais são os limites da API do daVinci-MagiHuman?

Duração do clipe: 5–10 s; Resoluções: 256p · 720p · 1080p; Proporções: 16:9 · 9:16; Tamanho do prompt (caracteres): 5,000. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.

Dá para testar o daVinci-MagiHuman sem escrever código?

Execute daVinci-MagiHuman no Playground com seu saldo de API em USD, sem chave de API. Cada execução aparece no histórico de desenvolvedor com o código correspondente.

Mais sobre o daVinci-MagiHuman