Rodin3D Skills

Una habilidad para generar modelos 3D a partir de una sola imagen, imágenes multivista o indicaciones de texto utilizando la API Hyper3D Rodin Gen-2.

GitHub

Documentación

Rodin3D Skills

Una habilidad para generar modelos 3D a partir de imágenes/multivistas o indicaciones de texto utilizando la API Hyper3D Rodin Gen-2.

Descripción general

Esta habilidad permite a la IA generar modelos 3D de alta calidad a través de la API Hyper3D Rodin Gen-2. Admite tanto la generación de imagen a 3D como de texto a 3D, con múltiples formatos de salida y niveles de calidad.

Características

Generar modelos 3D a partir de una o múltiples imágenes (hasta 5 imágenes)
Generar modelos 3D a partir de descripciones de texto
Soporte para múltiples formatos de salida: GLB, USDZ, FBX, OBJ, STL
Cinco niveles de generación: Gen-2, Detail, Smooth, Regular, Sketch
Consulta automática del estado de tareas y recuperación de resultados
Parámetros avanzados para material, modo de malla, valores de semilla y más

Instalación

Requisitos previos

Claude Code CLI instalado
Clave de API de Hyper3D (obtenerla de https://hyper3d.ai/api-dashboard)
Python 3.7+ (para scripts de backend)

Método 1: Instalar desde el Marketplace (Recomendado)

La forma más sencilla de instalar esta habilidad es a través del marketplace de plugins de Claude Code:

Agregar el marketplace (configuración única):

/plugin marketplace add DeemosTech/rodin3d-skills

Instalar el plugin:

/plugin install rodin3d-skill@rodin3d-skills

Instalar las dependencias de Python:
```
pip install requests pillow
```

Configurar tu clave de API:

export HYPER3D_API_KEY=your_api_key_here

O crea un archivo .env en tu proyecto:

echo 'HYPER3D_API_KEY=your_api_key_here' > .env
echo '.env' >> .gitignore

¡Eso es todo! La habilidad ahora está disponible como /rodin3d-skill en Claude Code.

Método 2: Instalación manual

Si prefieres instalar manualmente o quieres desarrollar localmente:

Clonar este repositorio:

git clone https://github.com/DeemosTech/rodin3d-skills.git
cd rodin3d-skills

Instalar las dependencias de Python:

cd skills/rodin3d-skill
pip install -r requirements.txt

Agregar el marketplace local:

/plugin marketplace add /path/to/rodin3d-skills
/plugin install rodin3d-skill@rodin3d-skills

Configurar tu clave de API (igual que en el Método 1, paso 4)

Verificar la instalación

Después de la instalación, verifica que la habilidad esté disponible:

/plugin list

Deberías ver rodin3d-skill en la lista de plugins habilitados.

Actualizar el plugin

Para actualizar a la última versión:

/plugin marketplace update rodin3d-skills
/plugin update rodin3d-skill@rodin3d-skills

Uso

Usar la habilidad

Una vez instalada, puedes interactuar con esta habilidad a través de:

Generar desde imagen:

Please generate a 3D model from this image: [provide image path]

Generar desde texto:

Please generate a 3D model of a medieval castle with high quality

Generar desde múltiples imágenes:

Please generate a 3D model from these images: [provide multiple images]

Uso directo de scripts

También puedes usar los scripts de Python directamente:

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

Configuración

Niveles de generación

Nivel	Descripción	Caso de uso	Velocidad
Gen-2	Máxima calidad, más avanzado	Modelos de producción final	Lenta
Detail	Alto detalle, alta resolución	Modelos que requieren detalles finos	Media
Smooth	Bordes claros, superficie suave	Geometrías simples, modelos estilizados	Media
Regular	Calidad y velocidad equilibradas	Uso general	Media
Sketch	Generación rápida, baja resolución	Validación de conceptos, iteración rápida	Rápida

Formatos de salida

GLB: Recomendado para web y la mayoría de software 3D
USDZ: Para plataformas Apple
FBX: Para motores de juegos y software de modelado 3D
OBJ: Formato 3D universal
STL: Para impresión 3D

Niveles de calidad

Alto: Mejor calidad, mayor tiempo de procesamiento
Medio: Calidad y velocidad equilibradas
Bajo: Procesamiento más rápido, menor calidad
Extra bajo: Procesamiento más rápido, calidad mínima

Parámetros

Parámetros básicos

Parámetro	Descripción	Opciones	Predeterminado
`--image`	Ruta(s) de imagen de entrada (máx. 5)	Rutas de archivo	-
`--prompt`	Indicación de texto para la generación	Texto	-
`--tier`	Nivel de generación	Gen-2, Detail, Smooth, Regular, Sketch	Gen-2
`--geometry-file-format`	Formato de salida	glb, usdz, fbx, obj, stl	glb
`--quality`	Nivel de calidad	high, medium, low, extra-low	medium
`--output`	Directorio de salida	Ruta de directorio	-

Parámetros avanzados

Parámetro	Descripción	Opciones	Predeterminado
`--material`	Tipo de material	PBR, Shaded, All	PBR
`--mesh-mode`	Topología de malla	Raw, Quad	Quad
`--use-original-alpha`	Usar canal alfa original	-	False
`--seed`	Valor de semilla aleatorio	0-65535	-
`--quality-override`	Recuento de polígonos personalizado	Entero	-
`--tapose`	Generar pose T/A	-	False
`--bbox-condition`	Caja delimitadora [W, H, L]	Tres enteros	-
`--addons`	Características adicionales	HighPack	-
`--preview-render`	Generar render de vista previa	-	False
`--poll-interval`	Intervalo de verificación de estado (segundos)	Entero	10
`--max-retries`	Intentos máximos de reintento	Entero	60

Mejores prácticas

Entrada de imagen

Usa imágenes de alta resolución (al menos 512 x 512 píxeles)
Asegura buena iluminación y detalles claros
Evita fondos con demasiados elementos
Usa múltiples ángulos para mejores resultados
Formatos compatibles: JPEG, PNG, WEBP
Límite de tamaño de archivo: 16MB
Rango de resolución: 512x512 a 4096x4096

Indicaciones de texto

Sé específico y detallado en tus descripciones
Menciona materiales y texturas
Incluye información de iluminación
Especifica el estilo (realista, caricatura, futurista, etc.)
Proporciona contexto para el objeto

Notas importantes

Los enlaces de descarga expiran en 10 minutos: las URL de resultados de la API son temporales. Descarga los modelos 3D inmediatamente después de que se complete la generación. No almacenes ni guardes en caché las URL.

Endpoints de la API

Endpoint	Propósito
`https://api.hyper3d.com/api/v2/rodin`	Enviar tarea de generación de modelos 3D
`https://api.hyper3d.com/api/v2/status`	Verificar el estado de la tarea
`https://api.hyper3d.com/api/v2/download`	Obtener enlaces de descarga para tareas completadas

Ejemplos de indicaciones

Aquí hay algunos ejemplos de indicaciones de texto para la generación 3D:

"Un modelo 3D detallado de un castillo medieval"
"Un paisaje urbano futurista con autos voladores"
"Un modelo 3D realista de un gato sentado en un sofá"
"Una escultura abstracta hecha de vidrio y metal"
"Un modelo 3D de una acogedora cabaña en el bosque"

Solución de problemas

Problemas con la clave de API

Si encuentras errores de autenticación:

Verifica que tu clave de API esté configurada correctamente
Comprueba que la clave sea válida y esté activa
Asegúrate de tener suficientes créditos de API

Fallos de generación

Si la generación falla:

Verifica los requisitos de formato y tamaño de imagen
Verifica que la indicación no esté vacía ni sea demasiado corta
Asegúrate de que el servicio de API esté disponible
Revisa los mensajes de error para problemas específicos

Documentación

Para documentación detallada, consulta:

SKILL.md - Documentación completa de la habilidad
assets/examples/README.md - Ejemplos de uso

Enlaces

Licencia

Licencia MIT - Consulta el archivo LICENSE para más detalles

Soporte

Para problemas o preguntas:

Envía un Issue en GitHub
Consulta SKILL.md para documentación detallada
Visita la documentación oficial de Hyper3D

Autor: HyperHuman
Versión: 1.0.0
Etiquetas: 3D Asset, Hyper3D, Rodin Gen-2, API, 3D Model, Image-to-3D, Text-to-3D