API de Texto a 3D

Este campo debe establecerse en "preview" al crear una tarea de vista previa.

Describe qué tipo de objeto es el modelo 3D. Máximo 600 caracteres.

Especifica el tipo de Generación de malla 3D.

Valores disponibles:

• standard: Generación de malla 3D normal de alto detalle.
• lowpoly: Genera una malla low-poly optimizada para polígonos más limpios.

ID del modelo que se va a usar. Valores disponibles: meshy-5, meshy-6, latest (Meshy 6).

Controla si se habilita la fase de remallado (remesh). Cuando se establece en false, la API devolverá directamente la malla triangular de mayor precisión.

Obsoleto (deprecated). Este parámetro ya no afecta la salida.

El campo symmetry_mode controla el comportamiento de simetría durante el proceso de generación del modelo.

Los valores válidos son:

• off: Deshabilita la simetría.
• auto: Determina y aplica automáticamente la simetría según la geometría de entrada.
• on: Fuerza la simetría durante la generación.

Especifica el pose mode para el modelo generado.

Valores disponibles:

• a-pose: Genera el modelo en una pose A.
• t-pose: Genera el modelo en una pose T.
• "" (cadena vacía): No se aplica ninguna pose específica.

Usa pose_mode en su lugar. Indica si se debe generar el modelo en una pose A/T.

No compatible con Meshy-6. Las solicitudes que usen Meshy-6 ignorarán art_style, y algunas combinaciones pueden causar errores. Valores disponibles: realistic, sculpture.

Cuando se establece en true, el contenido de entrada se revisará automáticamente para detectar contenido potencialmente dañino. Si se detecta contenido dañino, la tarea no procederá a la generación.

Se revisará el texto de prompt.

Especifica qué formatos de archivo 3D se deben incluir en la salida. Solo se generarán y devolverán los formatos solicitados, lo que puede reducir el tiempo de finalización de la tarea. Cuando se omite, se incluyen todos los formatos compatibles.

Valores disponibles: glb, obj, fbx, stl, usdz, 3mf

Cuando se establece en true, la tarea renderiza además una versión con fondo transparente (RGBA) de la vista previa y la devuelve como alpha_thumbnail_url en la respuesta GET. El campo existente thumbnail_url no cambia.

Cuando se establece en true, el servicio usa visión de IA para estimar automáticamente la altura real del objeto y redimensionar el modelo en consecuencia. El origen se establecerá de forma predeterminada en bottom a menos que origin_at se establezca explícitamente.

La solicitud no era aceptable. Causas comunes:

• Parámetro faltante: Falta un parámetro requerido (p. ej., prompt, mode).
• Parámetro no válido: art_style no es uno de los valores permitidos.
• Prompt demasiado largo: El prompt supera el límite de caracteres.

La autenticación falló. Comprueba tu clave de API.

Créditos insuficientes para realizar esta tarea.

Has superado tu límite de tasa.

Este campo debe establecerse en "refine" al crear una tarea de refinamiento.

El id de la tarea de vista previa correspondiente.

El estado de la tarea de vista previa proporcionada debe ser SUCCEEDED.

Genera mapas PBR (metálico, rugosidad, normal) además del color base. También se incluye un mapa de emisión cuando ai_model es meshy-6 o latest.

Genera la textura de color base con resolución 4K (4096×4096) para un mayor nivel de detalle.

Proporcione un prompt de texto adicional para guiar el proceso de texturizado. Máximo 600 caracteres.

Proporcione una imagen 2D para guiar el proceso de texturizado. Actualmente admitimos los formatos .jpg, .jpeg y .png.

Hay dos formas de proporcionar la imagen:

• URL de acceso público: Una URL accesible desde Internet público
• Data URI: Un Data URI codificado en base64 de la imagen. Ejemplo de un Data URI: data:image/jpeg;base64,<your base64-encoded image data>

ID del modelo que se usará para el refinamiento. Valores disponibles: meshy-5, meshy-6, latest (Meshy 6).

Cuando se establece en true, el contenido de entrada se analizará automáticamente para detectar contenido potencialmente dañino. Si se detecta contenido dañino, la tarea no continuará con la generación.

Se analizarán tanto el texto de texture_prompt como la imagen de texture_image_url.

Elimina brillos y sombras de la textura de color base, produciendo un resultado más limpio que funciona mejor con configuraciones de iluminación personalizadas.

Especifica qué formatos de archivo 3D se deben incluir en la salida. Solo se generarán y devolverán los formatos solicitados, lo que puede reducir el tiempo de finalización de la tarea. Si se omite, se incluyen todos los formatos admitidos.

Valores disponibles: glb, obj, fbx, stl, usdz, 3mf

Cuando se establece en true, la tarea renderiza además una versión con fondo transparente (RGBA) de la vista previa y la devuelve como alpha_thumbnail_url en la respuesta GET. El campo thumbnail_url existente no cambia.

Cuando se establece en true, el servicio usa visión de IA para estimar automáticamente la altura real del objeto y redimensionar el modelo en consecuencia. El origen será bottom de forma predeterminada, a menos que origin_at se establezca explícitamente.

La solicitud no era aceptable. Causas comunes:

• ID de tarea no válido: El preview_task_id no es válido o no existe.
• Tarea no lista: La tarea de vista previa aún no se ha completado correctamente.
• Incompatibilidad de modelo: El modelo de IA de la tarea de vista previa es incompatible con el modelo de refinamiento solicitado.

La autenticación falló. Compruebe su clave de API.

Créditos insuficientes para realizar esta tarea.

No se encontró la tarea de vista previa especificada por preview_task_id.

Ha superado su límite de tasa.

Identificador único de la tarea de Texto a 3D que se va a recuperar.

El ID de la tarea de Texto a 3D que se va a eliminar.

Número de página para la paginación.

Límite de tamaño de página. El máximo permitido es de 50 elementos.

Campo por el que ordenar.

Valores disponibles:

• +created_at: Ordenar por hora de creación en orden ascendente.
• -created_at: Ordenar por hora de creación en orden descendente.

Identificador único de la tarea de Texto a 3D que se va a transmitir.

Identificador único de la tarea. Aunque usamos un UUID ordenable por k para los ids de tarea como detalle de implementación, no debes hacer ninguna suposición sobre el formato del id.

Tipo de la tarea de Texto a 3D. Los valores posibles son text-to-3d-preview para tareas de la etapa de vista previa y text-to-3d-refine para tareas de la etapa de refinado.

URL descargable del archivo de modelo 3D con textura generado por Meshy. La propiedad de un formato se omitirá si el formato no se genera, en lugar de devolver una cadena vacía.

Este es el prompt sin modificar que se usó para crear la tarea.

Mantenido por compatibilidad con versiones anteriores. Este campo no tiene ningún impacto funcional en los modelos generados.

El art_style sin modificar que se usó para crear la tarea de vista previa. No es compatible con Meshy-6.

Mantenido por compatibilidad con versiones anteriores. Este campo no tiene ningún impacto funcional en los modelos generados.

Prompt de texto adicional proporcionado para guiar el proceso de aplicación de textura durante la etapa de refinado.

URL descargable de la imagen de textura que se usó para guiar el proceso de aplicación de textura.

URL descargable de la imagen de miniatura del archivo de modelo.

URL descargable de una versión con fondo transparente (RGBA) de thumbnail_url. Solo está presente cuando la tarea se creó con alpha_thumbnail: true y la vista previa transparente se renderizó correctamente; de lo contrario, este campo se omite.

URL descargable del video de vista previa. Se eliminará en una versión futura.

Progress de la tarea. Si la tarea aún no se ha iniciado, esta propiedad será 0. Una vez que la tarea se haya completado correctamente, pasará a ser 100.

Marca de tiempo de cuando se inició la tarea, en milisegundos. Si la tarea aún no se ha iniciado, esta propiedad será 0.

Marca de tiempo de cuando se creó la tarea, en milisegundos.

Marca de tiempo de cuando finalizó la tarea, en milisegundos. Si la tarea aún no ha finalizado, esta propiedad será 0.

Estado de la tarea. Los valores posibles son uno de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Un array de objetos de URL de textura que se generan a partir de la tarea. Normalmente esto solo contiene un objeto de URL de textura. Cada URL de textura tiene las siguientes propiedades:

El número de tareas precedentes.

Detalles del error para tareas fallidas. Consulta Errores para ver la referencia completa del objeto task_error.

El número de créditos consumidos por esta tarea. Está presente cuando el estado de la tarea es PENDING, IN_PROGRESS o SUCCEEDED. Devuelve 0 para tareas FAILED (los créditos se reembolsan en caso de fallo).