VisionCraft
Gere imagens e vídeos por meio das APIs Agnes AI. Chama scripts PowerShell em scripts/. A chave de API é lida da variável de ambiente AGNES_API_KEY.
Primeira vez? Veja Pré-requisitos. Para dicas de criação de prompts e detalhes de parâmetros, consulte
references/.
Referência Rápida
| Tarefa | Comando |
|---|---|
| Texto-para-Imagem | scripts/gen_image.ps1 -Prompt "..." |
| Imagem-para-Imagem | scripts/gen_image.ps1 -Prompt "..." -ImageUrl "https://..." |
| Texto-para-Vídeo | scripts/gen_video.ps1 -Prompt "..." |
| Imagem-para-Vídeo | scripts/gen_video.ps1 -Prompt "..." -Image "https://..." |
| Vídeo Multi-imagem | scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png" |
| Animação de Keyframes | scripts/gen_video.ps1 -Prompt "..." -Image "https://a.png","https://b.png" -Mode keyframes |
Padrões: Imagens 2048x2048. Vídeos 1920x1080 @ 60fps, 241 quadros (~4s).
Pré-requisitos
Defina a chave de API uma vez (persiste entre sessões):
[System.Environment]::SetEnvironmentVariable("AGNES_API_KEY", "sk-sua-chave-aqui", "User")
Ou apenas para a sessão atual:
$env:AGNES_API_KEY = "sk-sua-chave-aqui"
Verifique com echo $env:AGNES_API_KEY.
Como Usar Esta Habilidade
1. Identifique a solicitação
| O usuário diz | Modo |
|---|---|
| "faça/desenhe/gerar uma imagem de..." | Texto-para-Imagem |
| "edite/transforme/remodele esta imagem..." (URL fornecida) | Imagem-para-Imagem |
| "faça um vídeo/anime/gerar um clipe de..." | Texto-para-Vídeo |
| "anime esta foto / faça esta imagem se mover" (1 imagem) | Imagem-para-Vídeo |
| "mescle estas imagens em um vídeo" (múltiplas imagens) | Vídeo Multi-imagem |
| "transição suave / transformar de A para B" (2+ imagens) | Animação de Keyframes |
2. Refine o prompt se necessário
Se a solicitação for vaga, sugira brevemente um prompt mais rico antes de executar. Para estrutura de prompts e melhores práticas, veja references/prompt-guide.md.
3. Execute o script
Passe a proporção com -Ratio e a duração com -Seconds para o controle mais simples. Consulte references/parameters.md para todos os parâmetros.
# Exemplos:
scripts/gen_image.ps1 -Prompt "..." -Ratio 16:9
scripts/gen_video.ps1 -Prompt "..." -Ratio 9:16 -Seconds 8
4. Exiba o resultado
Os scripts imprimem uma linha MEDIA:<url> em caso de sucesso. Sempre exiba a URL em sua própria linha — nunca a enterre em um parágrafo. Se a plataforma suportar renderização de mídia inline, incorpore-a; caso contrário, apenas a URL é suficiente.
Nunca baixe o resultado para o disco local a menos que o usuário peça explicitamente.
Formato de Saída
Imagem:
✅ Imagem gerada.
MEDIA:https://platform-outputs.agnes-ai.space/images/...
Vídeo:
🎬 Vídeo gerado (4.0s, 1920x1080).
MEDIA:https://platform-outputs.agnes-ai.space/videos/...
Erros e Solução de Problemas
| Erro | Correção |
|---|---|
AGNES_API_KEY não definida | Defina-a (veja Pré-requisitos). Reinicie o terminal se necessário. |
| 401 Não Autorizado | Chave de API inválida ou expirada. |
| 400 Requisição Inválida | Verifique prompt, formato de tamanho, regra de contagem de quadros (8n+1, ≤441). |
| 503 Serviço Indisponível | Serviço ocupado. Aguarde 30s, tente novamente. |
| Timeout de vídeo (15 min) | O script imprime o video_id — consulte novamente mais tarde, a tarefa não foi abandonada. |
Para comportamento completo da API, veja references/api_docs.md.
Arquivos de Referência
references/api_docs.md— especificação completa da API Agnesreferences/prompt-guide.md— estrutura de prompts para imagem e vídeoreferences/parameters.md— todos os parâmetros dos scripts, com exemplos