API 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.

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

Valores disponibles:

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

ID del modelo a utilizar. Valores disponibles: meshy-5, meshy-6, latest (Meshy 6).

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

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: Desactiva la simetría.
• auto: Determina y aplica automáticamente la simetría basada en la geometría de entrada.
• on: Fuerza la simetría durante la generación.

Especifique el modo 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 una pose específica.

Use pose_mode en su lugar. Si generar el modelo en una pose A/T.

No es compatible con Meshy-6. Las solicitudes que usan 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 en busca de contenido potencialmente dañino. Si se detecta contenido dañino, la tarea no procederá a la generación.

El texto del prompt será revisado.

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

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

La solicitud fue inaceptable. Causas comunes:

• Falta un parámetro: 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 verifica tu clave de API.

Créditos insuficientes para realizar esta tarea.

Has excedido tu límite de tasa.

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

El ID de tarea de vista previa correspondiente.

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

Genera Mapas PBR (metálico, rugosidad, normal) además del color base. Se incluye un mapa de emisión cuando ai_model es meshy-6 o latest, excepto en texture_resolution: 8k (no se produce un mapa de emisión).

Resolución de textura de color base. Una de 2k (2048×2048), 4k (4096×4096), o 8k (8192×8192). Las resoluciones más altas capturan más detalles de la superficie. Solo se aplica al modo 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 600 caracteres.

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

Hay dos formas de proporcionar la imagen:

• URL accesible públicamente: Una URL accesible desde Internet pública.
• Data URI: Un Data URI con codificación base64 de la imagen. Ejemplo de un Data URI: data:image/jpeg;base64,<tu imagen codificada en base64>

ID del modelo a usar para refinar. Valores disponibles: meshy-5, meshy-6, latest (Meshy 6).

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

Tanto el texto de texture_prompt como la imagen de texture_image_url serán revisados.

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

Cuando se establece en true, el servicio utiliza visión AI para estimar automáticamente la altura real del objeto y redimensionar el modelo en consecuencia. El origen se establecerá en bottom 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 AI de la tarea de vista previa es incompatible con el modelo de refinado solicitado.

La autenticación falló. Por favor verifica tu clave de API.

Créditos insuficientes para realizar esta tarea.

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

Has excedido tu límite de tasa.

Identificador único de la tarea de Texto a 3D a obtener.

El ID de la tarea de Texto a 3D a eliminar.

Número de página para 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 tiempo de creación en orden ascendente.
• -created_at: Ordenar por tiempo de creación en orden descendente.

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

Identificador único de la tarea. Mientras 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 etapa de vista previa y text-to-3d-refine para tareas de etapa de refinado.

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

Este es el prompt no modificado que se usó para crear la tarea.

Mantenido para compatibilidad retroactiva. Este campo no tiene impacto funcional en los modelos generados.

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

Mantenido para compatibilidad retroactiva. Este campo no tiene impacto funcional en los modelos generados.

Texto adicional proporcionado para guiar el proceso de texturizado durante la etapa de refinado.

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

URL descargable para la imagen en miniatura del archivo del modelo.

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

URL descargable para el vídeo de vista previa. Será eliminado en una futura versión.

Progreso de la tarea. Si la tarea no ha comenzado aún, esta propiedad será 0. Una vez que la tarea ha tenido éxito, esto se convierte en 100.

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

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

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

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

Una matriz de objetos URL de texturas 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:

La cantidad de tareas precedentes.

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

La cantidad de créditos consumidos por esta tarea. Presente cuando el estado de la tarea es PENDING, IN_PROGRESS, o SUCCEEDED. Retorna 0 para tareas FAILED (los créditos se reembolsan en caso de fallos).