¿Qué son ChatGPT y Gemini y cómo funcionan con Neural4D?

Pueden generar código a partir de instrucciones en lenguaje natural. Proporciónales la documentación actual de la API de texto a 3D de Neural4D para que preparen un script que cree un modelo, compruebe el resultado y descargue el archivo. Revisa y prueba el script antes de usarlo.

¿Cómo escribir el prompt perfecto para generar modelos 3D?

Proporciona a la IA la documentación actual de la API de texto a 3D. Pídele que use un token Bearer almacenado en una variable de entorno, envíe una solicitud de generación, guarde el UUID devuelto, consulte el resultado, gestione los errores y descargue el modelo desde modelUrl.

Cómo crear aplicaciones 3D con herramientas de IA y la API de Neural4D

1. Crear automatizaciones y aplicaciones con herramientas de IA

¿Qué son ChatGPT y Gemini? Son herramientas de IA que pueden redactar y explicar código a partir de instrucciones en lenguaje natural. Proporciónales la referencia actual de la API de texto a 3D de Neural4D para que te ayuden a redactar un script de Python o Node.js que cree un modelo. La guía de inicio rápido de la API explica la autenticación y el flujo de resultados asíncronos. Revisa y prueba cualquier código generado antes de usarlo.

Puedes adaptar este flujo de trabajo para una aplicación 3D personalizada, un bot de Discord o una canalización de contenido automatizada. Comprueba que el recurso resultante cumpla los requisitos de tu proyecto antes de utilizarlo en un producto final.

¿Buscas desarrollo frontend? Si prefieres generar modelos manualmente y usar Gemini para escribir el código de visualización, como Three.js, consulta nuestra guía para crear sitios web 3D interactivos o mira el tutorial en vídeo de abajo:

¿Necesitas una integración de código directa? Si eres desarrollador y quieres escribir manualmente tus propios scripts de backend sin herramientas de IA, consulta nuestra guía específica sobre cómo integrar la API de Neural4D en flujos de trabajo personalizados.

2. ¿Cómo preparar tu clave de API de Neural4D?

Antes de ejecutar un script, necesitas una clave de API para la autenticación mediante Bearer. Para ver un tutorial detallado, consulta nuestra guía sobre cómo obtener y gestionar tu clave de API de Neural4D.

Paso 1	Inicia sesión en Neural4D Studio.
Paso 2	Haz clic en el icono de API situado en la parte inferior de la barra lateral izquierda.
Paso 3	Haz clic en Crear clave de API e introduce una etiqueta para la clave.
Paso 4	Haz clic en Confirmar y guarda la clave de forma segura.

No compartas tu clave en chats de IA, repositorios públicos ni código del lado del cliente. El script de abajo la leerá desde una variable de entorno local.

3. ¿Cómo pedir a una herramienta de IA un script de generación 3D?

Proporciona a la herramienta de IA la referencia actual de la API y el flujo de solicitudes que aparece a continuación. Copia este prompt tal como está escrito. Guarda tu clave de API real en tu ordenador y no la pegues nunca en el chat.

prompt

Write a Python script using requests to generate one 3D model with the Neural4D API.
Follow the current documentation:
https://docs.neural4d.com/en/api-reference/text-to-3d/generate-model-from-text
https://docs.neural4d.com/en/api-reference/model-management/retrieve-model

1. Read the API key from the NEURAL4D_API_KEY environment variable. If it is missing, show a clear error. Never print or hard-code the key.
2. Build the Authorization header as Bearer plus the key read from NEURAL4D_API_KEY. Send POST https://alb.neural4d.com:3000/api/generateModelWithText with Content-Type: application/json. Use JSON: {"prompt": "A futuristic sci-fi helmet", "modelCount": 1}.
3. Check the HTTP response and API errors. Save the first UUID from the response's "uuids" array.
4. Poll POST https://alb.neural4d.com:3000/api/retrieveModel with JSON {"uuid": saved_uuid} and the same headers. Use a configurable interval and a maximum wait time.
5. In the retrieval response, "codeStatus" 1 means generating and 0 means complete. Handle -1 (invalid or expired token), -2 (unknown UUID), and -3 (generation failed) as errors.
6. When complete, download the asset from "modelUrl" and preserve its file extension when available. Do not assume the result is an OBJ file.
7. Add request timeouts, helpful error messages, and comments explaining how to run the script.

Revisa el script generado comparándolo con las páginas enlazadas de la API antes de ejecutarlo. Si necesitas un archivo OBJ, utiliza la API independiente de conversión de formatos de modelos después de la generación. La conversión de formato consume puntos.

4. ¿Cómo probar el script generado en el terminal?

Cuando ChatGPT o Gemini proporcione el script de Python, revísalo y sigue estos pasos:

Guarda el código proporcionado en un archivo llamado generate_3d.py en tu ordenador.
Abre el terminal (Símbolo del sistema en Windows o Terminal en macOS/Linux).
Instala la biblioteca requests con pip install requests.
Configura NEURAL4D_API_KEY localmente con tu clave de API. En PowerShell, utiliza $env:NEURAL4D_API_KEY="your_key". En el Símbolo del sistema, utiliza set NEURAL4D_API_KEY=your_key. En macOS o Linux, utiliza export NEURAL4D_API_KEY="your_key".
Ejecuta python generate_3d.py. El script debería consultar el trabajo hasta que se complete, falle o alcance el tiempo de espera configurado.
Comprueba el modelo descargado y su formato de archivo. La documentación actual de la API muestra un resultado GLB; utiliza la conversión de formato si tu proyecto requiere OBJ u otro formato.

5. ¿Cuáles son los errores habituales al usar scripts generados por IA?

Comprueba la respuesta HTTP y el cuerpo de la respuesta de la API cuando falle una solicitud:

401 o codeStatus -1	Comprueba que `NEURAL4D_API_KEY` esté configurado y que la clave sea válida. Genera una clave nueva si la anterior ha caducado o se ha revocado.
400 Bad Request	Comprueba los nombres y valores de los campos JSON comparándolos con la referencia actual de texto a 3D.
402 o 403	Comprueba el saldo de tu cuenta, los permisos y cualquier restricción de la cuenta.
429 Too Many Requests	Espera antes de volver a intentarlo y reduce la frecuencia con la que el script envía solicitudes.
Respuesta de moderación	Una solicitud de generación puede devolver un mensaje de moderación en lugar de un array `uuids`. Lee el mensaje y modifica el prompt.
codeStatus -2 o -3	Confirma que el UUID procede de la respuesta de creación. Un valor de -2 significa que no se encontró; -3 indica que la generación falló.
ModuleNotFoundError	Instala la biblioteca requests de Python con `pip install requests`.
Tiempo de espera agotado del script	Puede que la tarea siga en curso. Consulta el endpoint de progreso de la tarea o vuelve a intentarlo con un tiempo de espera máximo mayor. No des por hecho que terminará en un plazo fijo.

Cómo crear aplicaciones 3D con herramientas de IA y la API de Neural4D

1. Crear automatizaciones y aplicaciones con herramientas de IA

2. ¿Cómo preparar tu clave de API de Neural4D?

3. ¿Cómo pedir a una herramienta de IA un script de generación 3D?

4. ¿Cómo probar el script generado en el terminal?

5. ¿Cuáles son los errores habituales al usar scripts generados por IA?

PRODUCTOS

FUNCIONES

EMPRESA

RECURSOS