Rodin3D Skills
Uma Skill para gerar modelos 3D a partir de uma única imagem, imagens multivista ou prompts de texto usando a API Hyper3D Rodin Gen-2.
Documentação
Rodin3D Skills
Uma Skill para gerar modelos 3D a partir de imagens/imagens multivisuais ou prompts de texto usando a API Hyper3D Rodin Gen-2.
Visão Geral
Esta skill permite que a IA gere modelos 3D de alta qualidade através da API Hyper3D Rodin Gen-2. Ela suporta tanto geração de imagem-para-3D quanto texto-para-3D, com múltiplos formatos de saída e níveis de qualidade.
Recursos
- Gere modelos 3D a partir de uma única imagem ou múltiplas imagens (até 5 imagens)
- Gere modelos 3D a partir de descrições de texto
- Suporte para múltiplos formatos de saída: GLB, USDZ, FBX, OBJ, STL
- Cinco níveis de geração: Gen-2, Detail, Smooth, Regular, Sketch
- Polling automático de status de tarefas e recuperação de resultados
- Parâmetros avançados para material, modo de malha, valores de semente e mais
Instalação
Pré-requisitos
- Claude Code CLI instalado
- Chave de API Hyper3D (obtenha em https://hyper3d.ai/api-dashboard)
- Python 3.7+ (para scripts de backend)
Método 1: Instalar pelo Marketplace (Recomendado)
A maneira mais fácil de instalar esta skill é através do marketplace de plugins do Claude Code:
-
Adicione o marketplace (configuração única):
/plugin marketplace add DeemosTech/rodin3d-skills -
Instale o plugin:
/plugin install rodin3d-skill@rodin3d-skills -
Instale as dependências Python:
pip install requests pillow -
Defina sua chave de API:
export HYPER3D_API_KEY=your_api_key_hereOu crie um arquivo
.envno seu projeto:echo 'HYPER3D_API_KEY=your_api_key_here' > .env echo '.env' >> .gitignore
Pronto! A skill agora está disponível como /rodin3d-skill no Claude Code.
Método 2: Instalação Manual
Se você preferir instalar manualmente ou quiser desenvolver localmente:
-
Clone este repositório:
git clone https://github.com/DeemosTech/rodin3d-skills.git cd rodin3d-skills -
Instale as dependências Python:
cd skills/rodin3d-skill pip install -r requirements.txt -
Adicione o marketplace local:
/plugin marketplace add /path/to/rodin3d-skills /plugin install rodin3d-skill@rodin3d-skills -
Defina sua chave de API (igual ao Método 1, passo 4)
Verificar Instalação
Após a instalação, verifique se a skill está disponível:
/plugin list
Você deve ver rodin3d-skill na lista de plugins habilitados.
Atualizando o Plugin
Para atualizar para a versão mais recente:
/plugin marketplace update rodin3d-skills
/plugin update rodin3d-skill@rodin3d-skills
Uso
Usando a Skill
Uma vez instalada, você pode interagir com esta skill através de:
Gerar a partir de imagem:
Please generate a 3D model from this image: [provide image path]
Gerar a partir de texto:
Please generate a 3D model of a medieval castle with high quality
Gerar a partir de múltiplas imagens:
Please generate a 3D model from these images: [provide multiple images]
Uso Direto de Script
Você também pode usar os scripts Python diretamente:
python scripts/generate_3d_model.py \
--image path/to/image.jpg \
--geometry-file-format glb \
--quality medium \
--output ./output
python scripts/generate_3d_model.py \
--prompt "A detailed 3D model of a medieval castle" \
--geometry-file-format glb \
--quality high \
--output ./output
Configuração
Níveis de Geração
| Nível | Descrição | Caso de Uso | Velocidade |
|---|---|---|---|
| Gen-2 | Qualidade mais alta, mais avançado | Modelos finais de produção | Lenta |
| Detail | Alto detalhe, alta resolução | Modelos que exigem detalhes finos | Média |
| Smooth | Bordas claras, superfície suave | Geometrias simples, modelos estilizados | Média |
| Regular | Qualidade e velocidade equilibradas | Uso geral | Média |
| Sketch | Geração rápida, baixa resolução | Validação de conceito, iteração rápida | Rápida |
Formatos de Saída
- GLB: Recomendado para web e a maioria dos softwares 3D
- USDZ: Para plataformas Apple
- FBX: Para engines de jogos e softwares de modelagem 3D
- OBJ: Formato 3D universal
- STL: Para impressão 3D
Níveis de Qualidade
- High: Melhor qualidade, tempo de processamento mais longo
- Medium: Qualidade e velocidade equilibradas
- Low: Processamento mais rápido, qualidade inferior
- Extra-low: Processamento mais rápido, qualidade mínima
Parâmetros
Parâmetros Básicos
| Parâmetro | Descrição | Opções | Padrão |
|---|---|---|---|
--image | Caminho(s) da imagem de entrada (máx. 5) | Caminhos de arquivo | - |
--prompt | Prompt de texto para geração | Texto | - |
--tier | Nível de geração | Gen-2, Detail, Smooth, Regular, Sketch | Gen-2 |
--geometry-file-format | Formato de saída | glb, usdz, fbx, obj, stl | glb |
--quality | Nível de qualidade | high, medium, low, extra-low | medium |
--output | Diretório de saída | Caminho do diretório | - |
Parâmetros Avançados
| Parâmetro | Descrição | Opções | Padrão |
|---|---|---|---|
--material | Tipo de material | PBR, Shaded, All | PBR |
--mesh-mode | Topologia da malha | Raw, Quad | Quad |
--use-original-alpha | Usar canal alfa original | - | False |
--seed | Valor de semente aleatória | 0-65535 | - |
--quality-override | Contagem personalizada de polígonos | Inteiro | - |
--tapose | Gerar pose T/A | - | False |
--bbox-condition | Caixa delimitadora [W, H, L] | Três inteiros | - |
--addons | Recursos adicionais | HighPack | - |
--preview-render | Gerar renderização de pré-visualização | - | False |
--poll-interval | Intervalo de verificação de status (segundos) | Inteiro | 10 |
--max-retries | Máximo de tentativas de repetição | Inteiro | 60 |
Melhores Práticas
Entrada de Imagem
- Use imagens de alta resolução (pelo menos 512 x 512 pixels)
- Garanta boa iluminação e detalhes claros
- Evite fundos poluídos
- Use múltiplos ângulos para melhores resultados
- Formatos suportados: JPEG, PNG, WEBP
- Limite de tamanho de arquivo: 16MB
- Faixa de resolução: 512x512 a 4096x4096
Prompts de Texto
- Seja específico e detalhado em suas descrições
- Mencione materiais e texturas
- Inclua informações de iluminação
- Especifique o estilo (realista, cartoon, futurista, etc.)
- Forneça contexto para o objeto
Notas Importantes
Links de download expiram em 10 minutos: URLs de resultados da API são temporárias. Baixe os modelos 3D imediatamente após a conclusão da geração. Não armazene nem armazene em cache as URLs.
Endpoints da API
| Endpoint | Finalidade |
|---|---|
https://api.hyper3d.com/api/v2/rodin | Enviar tarefa de geração de modelo 3D |
https://api.hyper3d.com/api/v2/status | Verificar status da tarefa |
https://api.hyper3d.com/api/v2/download | Obter links de download para tarefas concluídas |
Exemplos de Prompts
Aqui estão alguns exemplos de prompts de texto para geração 3D:
- "Um modelo 3D detalhado de um castelo medieval"
- "Uma paisagem urbana futurista com carros voadores"
- "Um modelo 3D realista de um gato sentado em um sofá"
- "Uma escultura abstrata feita de vidro e metal"
- "Um modelo 3D de um chalé aconchegante na floresta"
Solução de Problemas
Problemas com Chave de API
Se você encontrar erros de autenticação:
- Verifique se sua chave de API está definida corretamente
- Verifique se a chave é válida e está ativa
- Garanta que você tenha créditos de API suficientes
Falhas na Geração
Se a geração falhar:
- Verifique os requisitos de formato e tamanho da imagem
- Verifique se o prompt não está vazio ou muito curto
- Garanta que o serviço da API esteja disponível
- Revise as mensagens de erro para problemas específicos
Documentação
Para documentação detalhada, veja:
- SKILL.md - Documentação completa da skill
- assets/examples/README.md - Exemplos de uso
Links
Licença
Licença MIT - Veja o arquivo LICENSE para detalhes
Suporte
Para problemas ou perguntas:
- Envie um Issue no GitHub
- Consulte SKILL.md para documentação detalhada
- Visite a documentação oficial da Hyper3D
Autor: HyperHuman
Versão: 1.0.0
Tags: Ativo 3D, Hyper3D, Rodin Gen-2, API, Modelo 3D, Imagem-para-3D, Texto-para-3D