Nota del autor: tomando como ejemplo Qwen3.5-4B-GLB-3D-Coder, desglosamos el flujo de trabajo de la capa intermedia de código “texto → Three.js → GLB” y ofrecemos pasos prácticos para implementarlo.
Hacer que un Modelo de Lenguaje Grande produzca directamente archivos 3D utilizables es un problema que muchos desarrolladores independientes y pequeños equipos de juegos han enfrentado. Un modelo comunitario ajustado de 4B parámetros plantea otro enfoque: hacer que el modelo escriba código de Three.js y luego exportar GLB desde el navegador, separando la generación y la exportación en dos pasos.
No es otro artículo más de recopilación de herramientas de texto a 3D. Los activos exportados por Qwen3.5-4B-GLB-3D-Coder ya se pueden importar en el editor de Godot, y el desarrollador de la comunidad Naoki Kishida incluso creó con ellos una demo jugable de RPG 3D. Este artículo se centra en los métodos de ingeniería reutilizables que hay detrás de esta cadena.
Valor clave: después de leer este artículo, entenderás por qué funciona la capa intermedia de código y aprenderás a ejecutar el flujo completo desde la indicación hasta el activo de Godot, tanto en local como en la nube.
Puntos clave de la capa intermedia de código en Three.js
La capa intermedia de código consiste en que el modelo no genera directamente el archivo binario final, sino un programa ejecutable que, a su vez, produce el resultado final. En este caso, el modelo genera un archivo HTML independiente que contiene una escena de Three.js y un botón «Export GLB».
| Punto clave | Descripción | Valor para el desarrollador |
|---|---|---|
| Salida del modelo | Un único archivo HTML con una escena de Three.js y un botón de exportación | Se puede leer y modificar directamente; no es un archivo de caja negra |
| Producto final | Al hacer clic en el botón desde el navegador se descarga un GLB | Se puede importar en herramientas compatibles con GLB, como Godot |
| Alcance del entrenamiento | Cubre 25 áreas de assets de juego: personajes, armas, vehículos, edificios modulares, etc. | Una sola herramienta puede cubrir la mayoría de las necesidades de placeholders en la fase de prototipo |
| Forma de ejecución | Ofrece dos versiones cuantizadas GGUF: Q4_K_M y Q8_0 | Se puede ejecutar localmente con herramientas como LM Studio |
| Posicionamiento de calidad | Assets de juego low-poly, no orientados a producción realista o de nivel cinematográfico | Adecuado para prototipos, placeholders y proyectos con estilo |
Cabe aclarar que Qwen3.5-4B-GLB-3D-Coder es una versión preliminar independiente desarrollada por CCORE mediante fine-tuning de Qwen/Qwen3.5-4B, y no un lanzamiento oficial de Qwen. Según la model card, la mayoría de los resultados generados se pueden usar al primer intento, sobre todo con indicaciones en inglés, aunque algunos assets todavía requieren reintentos o modificaciones manuales del código.
Flujo de trabajo de la capa intermedia de código en Three.js
Todo el flujo se puede resumir en seis pasos: introducir la descripción, generar el HTML, guardar el archivo, previsualizarlo en el navegador, exportar el GLB e importarlo en el motor. Los dos primeros pasos los asume el modelo; la exportación la realiza el código que se ejecuta en el navegador, por lo que el modelo no necesita escribir directamente el contenido binario del GLB.
Si el asset necesita movimiento, por ejemplo una puerta que se abre, la indicación del sistema hará que el modelo añada animación y la incluya en el GLB exportado. Cuando no se solicita de forma explícita, el modelo genera assets estáticos por defecto. Por eso, conviene indicar claramente los requisitos de animación en la indicación.
Cinco lecciones de flujo de trabajo de la capa intermedia de código Three.js
La siguiente comparación es un juicio de ingeniería basado en este caso, no el resultado de un benchmark. Cada solución de generación 3D tiene su ámbito de aplicación; aquí solo comparamos las diferencias estructurales entre dos enfoques.
| Dimensión de comparación | Generación directa de archivos 3D | Capa intermedia de código Three.js |
|---|---|---|
| Salida del modelo | Mallas o activos binarios | Código de texto legible |
| Manejo de errores | Normalmente hay que regenerar o entrar en una herramienta de modelado para corregir | Se pueden modificar localmente la geometría, los materiales y las animaciones |
| Vista previa antes de exportar | Depende de un visor especializado | Basta con abrir el HTML en el navegador |
| Soporte de animación | Depende del modelo y del pipeline concretos | Se puede describir con código y exportar junto con el GLB |
| Ámbito en el que destaca | Depende de la solución concreta | Activos de bajo poligonaje con estructura clara |
| Limitación principal | El resultado no es fácil de editar con granularidad fina | Los activos de alto detalle o realistas quedan fuera de su ámbito de diseño |
Lección uno: elegir la capa de representación en la que el modelo es bueno. La fortaleza de los modelos de código es producir texto estructurado, y Three.js convierte justamente un activo 3D en un problema de programación. Este modelo solo tiene 4B de parámetros, pero puede asumir tareas de generación de activos; la clave es que la tarea se transformó en una forma que puede procesar.
Lección dos: hacer que el producto intermedio se pueda inspeccionar. El archivo HTML es tanto el resultado de la generación como el punto de entrada para la depuración. Cuando un material está mal colocado o un bucle de animación falla, a menudo se puede corregir a mano sin regenerar desde cero, lo que reduce enormemente el costo de un fallo puntual.
Lección tres: dejar el último paso en manos de herramientas deterministas. Los detalles del formato de archivo no tienen por qué quedar a cargo de un modelo probabilístico byte a byte. El ecosistema de Three.js ya cuenta con capacidades de exportación como GLTFExporter; el modelo solo necesita escribir la lógica que llama a la exportación. En general, cuantos más pasos se deleguen a herramientas maduras, menor será la incertidumbre en el plano del formato.
Lección cuatro: una tarea acotada con convenciones fijas es más útil que la capacidad de generalización. La indicación del sistema de este modelo es fija y el formato de salida está estrictamente limitado a un único archivo HTML. Al mismo tiempo, los datos de entrenamiento de 25 dominios garantizan la cobertura de tipos de activos. Con límites de tarea claros, un modelo pequeño tiene margen suficiente para desplegar su potencial.
Lección cinco: validar en el destino real. Que se vea bien en el navegador no significa que el activo sea utilizable; la tarjeta del modelo también muestra el resultado tras importarlo en el editor de Godot. El siguiente objetivo del autor va en la misma línea: lograr una generación fiable en un solo intento y, dentro de un marco de Agent, completar automáticamente la generación, las pruebas y la optimización.
Este enfoque no se limita a los activos de juegos. Los scripts de OpenSCAD pueden generar modelos CAD, Blender Python puede impulsar flujos de modelado, y SVG y Mermaid pueden describir gráficos y diagramas. Siempre que el formato de destino sea difícil de generar directamente, vale la pena preguntarse: ¿hay una capa de código que pueda producirlo de forma estable?
Consejo técnico: si quieres comparar el desempeño de distintos modelos escribiendo Three.js, puedes usar APIYI apiyi.com para invocar varios modelos con el mismo conjunto de indicaciones y luego evaluarlos de forma uniforme con la lista de verificación de aceptación que aparece más abajo.
Inicio rápido con la capa intermedia de código de Three.js: despliegue local
A continuación usamos LM Studio como ejemplo; no hace falta escribir código adicional en ningún momento. LM Studio puede cargar modelos GGUF directamente. Puedes buscar Qwen3.5-4B-GLB-3D-Coder en el explorador de modelos o descargar los archivos desde Hugging Face y cargarlos localmente.
Paso 1: elegir la versión cuantizada de GGUF
La ficha del modelo no publica requisitos exactos de VRAM, así que pruébalo con tu hardware real. La inferencia en CPU también es viable, pero la velocidad será notablemente menor.
| Versión | Características | Escenario recomendado |
|---|---|---|
| Q4_K_M | Archivo más pequeño, menor consumo de memoria, inferencia más rápida y cierta pérdida de calidad | GPU de portátil, equipos con recursos limitados, iteración rápida |
| Q8_0 | Archivo más grande, más cercano a la precisión completa | VRAM abundante; buscas mejorar la tasa de éxito al primer intento con recursos complejos |
Atención a las actualizaciones de versión: ambas versiones cuantizadas reemplazaron sus pesos el 2 de noviembre de 2026; el autor afirma que la calidad visual mejoró notablemente, pero los nombres de archivo no cambiaron. Si las descargaste antes de esa fecha, conviene eliminarlas y volver a descargarlas; de lo contrario, es posible que sigas usando la versión antigua.
Paso 2: configurar la indicación del sistema y los parámetros de muestreo
Este modelo está ajustado con un formato de instrucciones específico, así que se recomienda usar tal cual la indicación del sistema que proporciona la ficha del modelo, sin reescribirla:
Create game assets for the Godot editor， which uses GLB files. Create whatever the user requests as a good-quality low-poly asset using only Three.js in one complete standalone HTML file. The HTML must show the asset and include an Export GLB button that downloads a working GLB. If the requested asset needs animation， add it and include the animation in the exported GLB； otherwise make it static.
Pégala en el campo de mensaje del sistema de LM Studio y luego configura los parámetros de muestreo recomendados por el autor. Estos valores son el punto de partida que usó el autor en sus pruebas, no requisitos estrictos; puedes ajustarlos una vez que todo funcione.
| Parámetro | Valor recomendado | Ubicación de configuración |
|---|---|---|
temperature |
0.8 | Parámetros de generación de LM Studio |
top_k |
40 | Parámetros de generación de LM Studio |
top_p |
0.95 | Parámetros de generación de LM Studio |
min_p |
0.0 | Parámetros de generación de LM Studio |
Paso 3: generar y exportar el GLB
La indicación del usuario debe ser breve, concreta y, en lo posible, en inglés. Puedes empezar probando Create a blue goblin brute o Build a jungle siege platform; si necesitas animación, escríbela como Create a wooden gate with an opening animation. Después, sigue este orden:
- Envía la indicación y espera a que el modelo genere el HTML completo.
- Guarda el contenido generado como un archivo
.html. - Abre el archivo en el navegador y confirma que el recurso se renderiza correctamente.
- Haz clic en el botón «Export GLB» y descarga el archivo
.glb. - Importa el GLB en Godot, o en otra herramienta que admita este formato.
Si la página aparece en blanco, abre primero las herramientas de desarrollo del navegador y revisa los errores de la consola. Algunos scripts pueden toparse con las restricciones de archivos locales del navegador si abres el archivo con doble clic; en ese caso, ejecuta python -m http.server en el directorio del archivo y accede mediante la dirección local.
Paso 4: validar los recursos con una lista de comprobación
No te quedes solo con la vista previa del navegador. Para cada recurso, conviene revisar los siguientes puntos:
- Estructura: que las piezas estén completas y que no haya desalineaciones ni intersecciones evidentes.
- Materiales: que los colores y materiales coincidan con la vista previa después de importar en el motor.
- Animación: que la animación se haya incluido realmente en el GLB y se pueda reproducir dentro del motor.
- Dimensiones y origen: que la escala y el pivote encajen con lo que necesita la escena; puede que esta parte requiera ajustes manuales.
- Facilidad de corrección: para los problemas menores, prioriza cambiar el código; para los estructurales, vuelve a generar el recurso.
Solución de acceso en la nube para la capa intermedia de código de Three.js
Una de las ventajas de la capa intermedia de código es que no está atada a un modelo concreto. Siempre que un modelo pueda generar Three.js funcional, puede integrarse en el mismo flujo. Según la información pública, Qwen3.5-4B-GLB-3D-Coder se distribuye actualmente en formato GGUF y está orientado sobre todo a inferencia local; si tu equipo no puede ejecutarlo con comodidad o quieres comparar el rendimiento de un modelo general de codificación, puedes usar la API en la nube.
APIYI ofrece llamadas a la API para varios modelos y es compatible con los formatos de interfaz de OpenAI y Anthropic. Los clientes existentes normalmente solo necesitan ajustar la dirección de la interfaz, la clave API y el nombre del modelo. Ten en cuenta que, si el modelo con ajuste fino mencionado está disponible para llamadas en la nube, debes guiarte por lo que muestre realmente la lista de modelos. Para ver la configuración concreta, consulta la documentación de APIYI: docs.apiyi.com.
| Enfoque | Características principales | Casos de uso | Criterio de coste | Plataformas disponibles |
|---|---|---|---|---|
| Modelo local con ajuste fino | Ajustado para activos GLB; se puede usar sin conexión tras la descarga | Generación por lotes de activos provisionales; necesidad de ejecución sin conexión | Sin coste por llamada; requiere hardware propio | Herramientas de ejecución GGUF como LM Studio |
| Modelo general de codificación en la nube | No requiere cómputo local; facilita el cambio y la comparación | Equipos con recursos limitados o necesidad de probar indicaciones complejas | Según la página de precios de APIYI | APIYI apiyi.com y canales oficiales de cada modelo |
| Híbrido local y nube | Ejecuta el volumen en local y deja los activos difíciles a la nube | Equipos que buscan equilibrar coste y tasa de éxito | La parte en la nube, según la página de precios de APIYI | Herramientas locales combinadas con una plataforma API |
Pasos para invocar un modelo de generación de Three.js a través de la interfaz
- Crea una clave API en la consola de APIYI y confirma en la documentación la dirección actual de la interfaz; no copies la dirección de tutoriales de terceros.
- Elige el formato de interfaz de OpenAI o Anthropic según tu cliente actual y completa
base_urly la clave API. - Selecciona en la lista de modelos el modelo que quieras probar y escribe su nombre en el campo
model. - Incluye la indicación del sistema del apartado anterior en el mensaje
system. Como el modelo general no está ajustado para esta tarea, puedes añadir restricciones como «genera únicamente HTML completo». - Guarda la respuesta como un archivo
.html; los pasos posteriores de vista previa, exportación y validación son los mismos que en la solución local.
El servicio local de LM Studio también ofrece una interfaz compatible con OpenAI. Por eso, puedes cambiar entre local y nube con el mismo cliente, solo tienes que modificar la dirección de la interfaz y el nombre del modelo. De este modo, las etapas de vista previa, exportación y validación posteriores a la capa intermedia de código no necesitan cambios.
Nota sobre facturación: los precios unitarios de los modelos, los criterios de facturación de entrada y salida y los precios de caché pueden cambiar. Este artículo no incluye cifras concretas: toma siempre como referencia los datos reales de la página de precios de APIYI: https://docs.apiyi.com/models.
Preguntas frecuentes (FAQ)
P1: ¿Qué es el flujo de trabajo de capa intermedia de código con Three.js?
Consiste en hacer que el modelo primero escriba un programa de Three.js, y que sea ese programa el que renderice y exporte el GLB, en lugar de que el modelo genere directamente un archivo 3D. Así se puede previsualizar y modificar el resultado antes de exportarlo.
P2: ¿Qwen3.5-4B-GLB-3D-Coder puede generar GLB directamente?
No. Lo que produce es un archivo HTML independiente, que hay que abrir en el navegador y pulsar el botón «Export GLB» para obtener el archivo GLB.
P3: ¿El GLB exportado solo sirve para Godot?
No. La indicación del sistema está orientada al flujo de trabajo de Godot, pero GLB es un formato universal que también pueden importar herramientas como Unity, Blender y visores 3D web. Eso sí, el resultado tras la importación debe verificarse por separado en cada herramienta.
P4: ¿Para qué escenarios de aplicación es más adecuado este modelo?
Es especialmente adecuado para prototipos de juegos y assets de relleno de estilo low poly, como NPC, armas, vehículos, edificios modulares y trampas. Si necesitas assets finales altamente personalizados, lo normal es que todavía tengas que hacer ajustes manuales después de la importación.
P5: Si no tengo una GPU adecuada, ¿cómo puedo probar este flujo mediante API?
Puedes llamar a los modelos de código de la lista de modelos mediante APIYI apiyi.com y configurar la interfaz en formato OpenAI o Anthropic según la documentación. Una vez que el modelo genera el HTML, la previsualización y la exportación posteriores se realizan en el navegador local.
P6: ¿Cómo se calculan los costes de las llamadas en la nube?
El precio unitario y el criterio de facturación varían según el modelo; consulta directamente la página de precios de APIYI: https://docs.apiyi.com/models. Se recomienda hacer primero unas cuantas pruebas con pocas indicaciones y después estimar el coste según el uso real.
P7: ¿Es obligatorio el archivo de proyección visual?
No es obligatorio. El archivo opcional de proyección visual BF16 ocupa unos 644 MiB y sirve para introducir imágenes de referencia en un entorno de ejecución compatible con GGUF multimodal de Qwen3.5. Si solo usas indicaciones de texto, puedes no descargarlo.
P8: ¿Qué limitaciones tiene actualmente esta solución?
Por ahora es una versión preliminar: el conjunto de entrenamiento se centra en indicaciones sencillas, la capacidad de generalización ante necesidades complejas o poco frecuentes es limitada y no está pensada para assets fotorrealistas. El autor tiene previsto publicar el conjunto de datos y los pesos Safetensors, y entrenar una versión más grande con unas 100 000 muestras y una ventana de contexto de 8K a 128K tokens, pero ese contenido aún no se ha publicado.
Puntos clave de la capa intermedia de código Three.js
- Idea central: dejar que el modelo escriba código Three.js ejecutable y que luego el programa exporte un GLB.
- Ventaja clave: el producto intermedio se puede previsualizar, leer y modificar por partes, lo que reduce el coste del fracaso.
- Primeros pasos en local: cargar un GGUF con LM Studio, junto con una indicación de sistema fija y los parámetros de muestreo recomendados.
- Aviso de versión: los pesos descargados antes del 2 de noviembre conviene eliminarlos y volver a descargarlos.
- Alcance: sirve para prototipos low-poly y recursos de relleno; no para producción fotorrealista o de nivel cinematográfico.
- Ruta en la nube: se puede acceder a los modelos mediante APIYI con formato OpenAI o Anthropic y comparar resultados.
- Extensión del método: también se puede aplicar este diseño de capa intermedia en escenarios como Blender Python u OpenSCAD.
Resumen
La lección de Qwen3.5-4B-GLB-3D-Coder no está solo en que un modelo pequeño pueda generar recursos para videojuegos, sino en que redefine el reparto de responsabilidades entre el modelo y las herramientas:
- El modelo se encarga de expresar: convierte una descripción en lenguaje natural en código Three.js con una estructura clara.
- La herramienta se encarga de materializar: el navegador y la lógica de exportación generan un archivo GLB estándar.
- La validación determina si sirve: solo cuando se importa en el motor objetivo y supera las comprobaciones se puede dar por terminado.
Recomiendo empezar con un objeto estático sencillo para recorrer todo el flujo y, después, probar poco a poco animaciones y recursos más complejos. Si quieres comparar varios modelos en la nube, puedes llamarlos de forma unificada a través de APIYI; la forma de integración está en docs.apiyi.com y los precios deben tomarse de los datos reales en https://docs.apiyi.com/models.
📚 Referencias
- Introducción al modelo Qwen3.5-4B-GLB-3D-Coder: posicionamiento del modelo, 25 dominios de recursos y hoja de ruta futura
- Enlace:
mindstudio.ai/blog/qwen3-5-4b-glb-3d-coder-model -
Descripción: útil para conocer la visión general del proyecto y casos de la comunidad
-
Guía para ejecutar Qwen3.5-4B-GLB-3D-Coder en local: mecanismo de generación, versiones cuantizadas y análisis de idoneidad
- Enlace:
mindstudio.ai/blog/qwen3-5-4b-glb-3d-coder-local -
Descripción: útil para evaluar si el modelo encaja con las necesidades de tu proyecto
-
Guía de configuración de LM Studio: indicaciones del sistema, parámetros de muestreo y pasos para exportar GLB
- Enlace:
mindstudio.ai/blog/run-qwen3-5-glb-3d-coder-locally -
Descripción: útil para completar el despliegue local paso a paso
-
Documentación y página de precios de APIYI: instrucciones de integración de la API y datos de precios del modelo
- Enlace:
docs.apiyi.comydocs.apiyi.com/models - Descripción: la configuración de la API y la información de facturación se rigen por el contenido más reciente publicado aquí
Autor: Equipo técnico de APIYI
Contacto técnico: si tienes dudas durante la integración, puedes escribirnos a través del sitio oficial de APIYI, apiyi.com; también puedes consultar más material en el centro de documentación, docs.apiyi.com
