MiniAPI vídeo, imagem e áudio
MiniAPI é uma única chave de API pré-paga para modelos de vídeo, imagem e áudio em https://api.minicut.ai.
Um modelo marcado como coming soon em models tem preço, mas ainda não aceita trabalhos; escolha outro.
Os preços são por segundo ou por imagem, definidos antes da execução do trabalho. Um trabalho que falha não é cobrado.
Os créditos nunca expiram.
Script auxiliar (Node 18+, nada para instalar): node scripts/miniapi.mjs <comando>, execute a partir da pasta desta skill.
Passo 0. Chave
- Se
MINIAPI_KEYnão estiver definida, informe o usuário em uma linha: crie uma chave em https://api.minicut.ai/console/keys?utm_source=skills-sh&utm_medium=skill&utm_campaign=miniapi-video , adicione fundos (mínimo $10), depoisexport MINIAPI_KEY=mapi_live_.... Aguarde. - Nunca imprima a chave. Nunca a escreva em um arquivo no projeto.
Passo 1. Escolha o modelo
Execute node scripts/miniapi.mjs models para cada id com seu preço inicial.
Execute node scripts/miniapi.mjs model <id> para ver os parâmetros, limites e preços desse modelo.
Use apenas os parâmetros listados na página desse modelo. Um parâmetro que o modelo não aceita será recusado com erro 422.
Padrões quando o usuário não especifica um:
| Trabalho | Id do modelo | Por quê |
|---|---|---|
| Vídeo, melhor qualidade | seedance-2.5 | 4 a 30 s, até 1080p, referências, som ativado por padrão |
| Vídeo, rascunho barato | seedance-2.0-mini | a partir de $0,054 / s |
| Imagem | leia models e escolha o modelo de imagem que o usuário nomear, senão o modelo de imagem mais barato |
Passo 2. Orçamento, depois permissão
- Construa o corpo JSON a partir da página do modelo.
- Execute
node scripts/miniapi.mjs quote <id> '<json>'. Um orçamento é gratuito e não executa nada. - Mostre ao usuário a linha PRICE e peça um sim. Nunca envie sem isso.
- Um sim cobre um trabalho. Uma repetição ou um segundo clipe exige um novo orçamento e um novo sim.
Passo 3. Executar
node scripts/miniapi.mjs run <id> '<json>' --yes --out <pasta>
Ele faz o orçamento novamente, envia, aguarda, baixa o arquivo para <pasta> e imprime SAVED <caminho> e CHARGED <preço>.
Mostre ao usuário o caminho salvo. Para uma imagem, abra-a. Para um clipe, forneça o caminho.
Erros
| Saída | Significado | Ação |
|---|---|---|
| 3 | sem chave | Passo 0 |
| 4 | saldo muito baixo | informe ao usuário o preço e o link de adicionar fundos que foi impresso |
| 5 | MiniAPI recusou o corpo | leia a mensagem, corrija o campo pela página do modelo, faça o orçamento novamente |
| 7 | o trabalho falhou | não foi cobrado. Informe isso e ofereça uma tentativa modificada com um novo orçamento |
Exemplo
Usuário: "faça um clipe de 5 segundos de uma raposa vermelha correndo na neve ao amanhecer, 720p"
node scripts/miniapi.mjs quote seedance-2.5 '{"prompt":"uma raposa vermelha corre na neve ao amanhecer","resolution":"720p","duration":5}'
# PRICE 1.750000 USD ... Orçamento é gratuito. Nada foi executado.
# (pergunte ao usuário, aguarde o sim)
node scripts/miniapi.mjs run seedance-2.5 '{"prompt":"uma raposa vermelha corre na neve ao amanhecer","resolution":"720p","duration":5}' --yes --out clipes
Documentação: https://api.minicut.ai/docs . Cada modelo em Markdown: https://api.minicut.ai/llms.txt