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 800 caracteres.

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

Valores disponibles:

• standard: Generación de malla 3D regular de alto detalle.
• smart-topology: Elige el modelo Smart Topology con ai_model (meshy-t2).
• lowpoly (obsoleto): Genera una malla low-poly optimizada para polígonos más limpios. Recomendamos usar smart-topology en su lugar.

ID del modelo a usar. Los valores disponibles dependen de model_type.

Generación estándar (model_type: standard):

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (obsoleto): usa meshy-7.1 en su lugar.

Generación Smart Topology (model_type: smart-topology):

• meshy-t2 (predeterminado): el modelo Smart Topology — topology más limpia, partes separadas de forma nativa, salida triangular y un número de caras que puedes establecer con target_polycount.

Pasada de generación de geometría. 2k ejecuta la pasada Ultra a 2048³; 4k la ejecuta a 4096³ para el detalle de superficie más fino.

Valores disponibles: standard, 2k, 4k

Usa geometry_resolution en su lugar. ultra_mode: true equivale a geometry_resolution: "2k".

Controla si se habilita la fase de remallado. Para el modelo de mayor calidad, recomendamos establecer should_remesh en false.

Número objetivo de polígonos (caras) en la salida. El recuento real puede desviarse del objetivo según la geometría.

target_polycount tiene efecto en dos casos independientes:

• Remallado — con should_remesh: true en un modelo standard. La malla se remalla (decima) hasta aproximadamente este recuento. Rango de 100 a 300,000, predeterminado 30,000. Si se establece decimation_mode, este tiene prioridad y target_polycount se ignora.
• Smart Topology — con model_type: smart-topology y ai_model: meshy-t2. El modelo se genera directamente con este recuento de caras; no se ejecuta ningún remallado y should_remesh no es necesario. Rango de 100 a 15,000, predeterminado 4,000.

Obsoleto. Este parámetro ya no afecta la salida.

El campo symmetry_mode controla el comportamiento de la 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 mode de pose 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 es 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 evaluará automáticamente en busca de contenido potencialmente dañino. Si se detecta contenido dañino, la tarea no continuará con la generación.

Se evaluará el texto de prompt.

Especifica qué formatos de archivo 3D se incluirán 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 además renderiza 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 por IA para estimar automáticamente la altura real del objeto en el mundo real y redimensionar el modelo en consecuencia. El origen será bottom de forma predeterminada, a menos que origin_at se establezca explícitamente.

La solicitud fue inaceptable. Causas comunes:

• Parámetro faltante: Falta un parámetro requerido (por ejemplo, prompt, mode).
• Parámetro inválido: art_style no es uno de los valores permitidos.
• Prompt demasiado largo: El prompt excede el límite de caracteres.
• Modelo no compatible para low poly: ai_model: "meshy-6-lite" no admite model_type: "lowpoly".
• Modelo no compatible para Ultra: geometry_resolution requiere meshy-7.1 o latest.

Error de autenticación. Verifica 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 refine.

El id de la tarea de vista previa correspondiente.

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

Genera mapas PBR (metallic, roughness, normal) además del color base. También se incluye un mapa de emisión cuando ai_model es meshy-6, excepto en texture_resolution: 8k (no se produce ningún mapa de emisión). meshy-6-lite, meshy-7.1 y latest no producen un mapa de emisión.

Resolución de la textura de color base. Uno de 2k (2048×2048), 4k (4096×4096), u 8k (8192×8192). Las resoluciones más altas capturan más detalle de superficie. Solo se aplica al mode refine.

Use texture_resolution en su lugar — equivalente a texture_resolution: "4k". Cuando ambos están establecidos, texture_resolution tiene prioridad.

Proporcione un prompt de texto adicional para guiar el proceso de texturizado. Máximo 800 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 que es accesible desde internet público
• Data URI: Un Data URI de la imagen codificado en base64. Ejemplo de un data URI: data:image/jpeg;base64,<your base64-encoded image data>

ID del modelo a usar para el refine.

Valores disponibles:

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (obsoleto): use meshy-7.1 en su lugar.

Omita este parámetro para heredar el modelo usado por la tarea de vista previa, lo que mantiene una vista previa y su refine en el mismo modelo de extremo a extremo. Pase un valor explícito para anular esa herencia.

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

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

Elimina los reflejos y las 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 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 admitidos.

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

Cuando se establece en true, la tarea renderiza adicionalmente 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 se modifica.

Cuando se establece en true, el servicio usa visión por IA para estimar automáticamente la altura del objeto en el mundo real y redimensionar el modelo en consecuencia. El origen tendrá como valor predeterminado bottom a menos que se establezca explícitamente origin_at.

La solicitud fue inaceptable. Causas comunes:

• ID de tarea inválido: El preview_task_id es inválido o no existe.
• Tarea no lista: La tarea de vista previa aún no se ha completado con éxito.
• Desajuste de modelo: El modelo de IA de la tarea de vista previa es incompatible con el modelo de refine solicitado.

Falló la autenticación. Por favor, verifique 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 excedido su límite de tasa.

Identificador único de la tarea de Texto a 3D que se desea 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 100 elementos.

Campo por el cual 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 desea transmitir.

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

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

URL descargable del archivo de modelo 3D texturizado 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.

Se mantiene 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 preview. No es compatible con Meshy-6.

Se mantiene 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 texturizado durante la etapa refine.

Obsoleto; consulta geometry_resolution en su lugar.

El nivel Ultra en el que se ejecutó la tarea preview (2k o 4k); se omite para standard.

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

URL descargable de la imagen en miniatura del archivo del 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 futura versión.

Progreso de la tarea. Si la tarea aún no ha comenzado, esta propiedad será 0. Una vez que la tarea se haya completado con éxito, será 100.

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

Marca de tiempo de cuándo se creó la tarea, en milisegundos.

Marca de tiempo de cuándo se 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 generados 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. 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).