API de Texto a 3D

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

Describa 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-5, meshy-6, meshy-7, latest (Meshy 7)

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 en triángulos y un recuento de caras que puedes establecer con target_polycount.

Habilita la generación Ultra para una geometría de mayor fidelidad con detalles de superficie más finos. La generación toma más tiempo y añade 5 créditos.

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 dependiendo de la geometría.

target_polycount entra en vigor 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, 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 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.

Use 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 examinará automáticamente para detectar contenido potencialmente dañino. Si se detecta contenido dañino, la tarea no procederá a la generación.

Se examinará el texto de prompt.

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 thumbnail_url existente no cambia.

Cuando se establece en true, el servicio usa visión por IA para estimar automáticamente la altura real del objeto y redimensionar el modelo en consecuencia. El origin 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.

La autenticación falló. Por favor, verifique su clave de API.

Créditos insuficientes para realizar esta tarea.

Ha excedido su 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 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 mapa de emisión). meshy-7 (y latest) no produce 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 se establecen ambos, 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 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 refinamiento. Valores disponibles: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

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

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

Elimina los brillos y sombras de la textura de color base, produciendo un resultado más limpio que funciona mejor bajo 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 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 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 ha tenido éxito.
• 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ó. 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 50 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 va a transmitir.

Identificador único de la tarea. Aunque usamos un UUID k-sortable 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 preview y text-to-3d-refine para tareas de la etapa refine.

URL descargable del archivo del modelo 3D texturizado generado por Meshy. La propiedad de un formato se omitirá si el formato no se generó, 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.

Refleja el valor de ultra_mode con el que se creó la tarea preview. Solo está presente en tareas preview de meshy-7 (o latest) que establecieron explícitamente ultra_mode; en caso contrario, se omite.

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.

Progress de la tarea. Si la tarea aún no ha comenzado, esta propiedad será 0. Una vez que la tarea haya finalizado con éxito, se convertirá en 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 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 recuento de tareas precedentes.

Detalles del error para tareas fallidas. Consulta Errores para 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).