API de Multi-imagen a 3D

La API de Multi-imagen a 3D es una función que te permite integrar las capacidades de Multi-imagen a 3D de Meshy en tu propia aplicación. En esta sección, encontrarás toda la información que necesitas para comenzar a usar esta API.

POST/openapi/v1/multi-image-to-3d

Crear una tarea de Multi-imagen a 3D

Este endpoint te permite crear una nueva tarea de Multi-imagen a 3D. Consulta El objeto de tarea Multi-imagen a 3D para ver qué propiedades incluye el objeto de tarea Multi-imagen a 3D.

La tarea se ejecuta en segundo plano. Para saber cuánto tiempo suele tardar, consulta Tiempos de procesamiento.

Parámetros

Solo se requiere uno de input_task_id o image_urls. Si se proporcionan ambos, input_task_id tiene prioridad.

Name
input_task_id
Type
string
Requerido
Description
El ID de una tarea de generación de imágenes completada cuya salida (1 a 4 imágenes) debe usarse como entrada. Esta tarea debe ser una de las siguientes: Texto a imagen, Imagen a imagen, Texto a imagen Multivista o Imagen a imagen Multivista. Además, debe haberse ejecutado mediante la API y tener un estado SUCCEEDED.

Name
image_urls
Type
array
Requerido
Description
Proporciona de 1 a 4 imágenes para que Meshy las use en la creación del modelo. Actualmente admitimos los formatos .jpg, .jpeg, .png y .webp. Para obtener mejores resultados, todas las imágenes deben mostrar el mismo objeto desde diferentes ángulos.
Tamaño máximo de archivo: 20 MB por imagen.
Hay dos formas de proporcionar cada 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 Data URI: data:image/jpeg;base64,<tus datos de imagen codificados en base64>.
Para meshy-7.1 (o latest), la primera imagen se usa como vista principal (frontal). El orden de las imágenes restantes no importa.

Name
ai_model
Type
string
predeterminado latest
Description
ID del modelo a utilizar.
Valores disponibles:
- meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
- meshy-7 (obsoleto): usa meshy-7.1 en su lugar.
Name
geometry_resolution
Type
string
predeterminado standard
Description
Pasada de generación de geometría. 2k ejecuta la pasada Ultra a 2048³. Requiere meshy-7.1 o latest.
Valores disponibles: standard, 2k
Name
ultra_mode
Type
boolean
⚠ obsoleto
predeterminado false
Description
Usa geometry_resolution en su lugar. ultra_mode: true es equivalente a geometry_resolution: "2k".
Name
should_texture
Type
boolean
predeterminado true
Description
Determina si se generan texturas. Establecerlo en false omite la fase de texturizado, proporcionando una malla sin texturas.

Solo aplica cuando should_texture = true

Name
enable_pbr
Type
boolean
predeterminado false
Description
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, excepto con texture_resolution: 8k. meshy-6-lite, meshy-7.1 y latest no producen un mapa de emisión.
Name
texture_resolution
Type
string
predeterminado 2k
Description
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 la superficie.
4k y 8k requieren ai_model meshy-6, meshy-7.1 o latest. En 8k, no se produce ningún mapa de emisión.
Name
hd_texture
Type
boolean
⚠ obsoleto
predeterminado false
Description
Usa texture_resolution en su lugar — equivalente a texture_resolution: "4k". Cuando se establecen ambos, texture_resolution tiene prioridad.
Name
texture_prompt
Type
string
Description
Proporciona un prompt de texto para guiar el proceso de texturizado. Máximo 800 caracteres.
Name
texture_image_url
Type
string
Description
Proporciona una imagen 2D para guiar el proceso de texturizado. Actualmente admitimos los formatos .jpg, .jpeg, .png y .webp.
Tamaño máximo de archivo: 20 MB.
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 Data URI: data:image/jpeg;base64,<tus datos de imagen codificados en base64>
El texturizado de imagen puede no funcionar de forma óptima si hay diferencias geométricas sustanciales entre el asset original y la imagen subida. Solo se puede usar texture_image_url o texture_prompt para guiar el proceso de texturizado, no ambos. Si se proporcionan ambos parámetros, se usará texture_prompt para texturizar el modelo de forma predeterminada.
Name
texture_image_urls
Type
string[]
Description
Proporciona de 1 a 4 imágenes que muestren el mismo objeto desde diferentes vistas para guiar el texturizado. La primera imagen es la vista principal (frontal); el orden de las vistas restantes (izquierda, trasera, derecha) no importa.
Cada elemento acepta los mismos formatos que texture_image_url (una URL de acceso público o un Data URI en base64, .jpg/.jpeg/.png/.webp).
Tamaño máximo de archivo: 20 MB por imagen.
Estas imágenes solo guían la textura y son independientes de image_urls: las dos listas pueden contener imágenes diferentes y un número distinto de imágenes.
Requiere ai_model meshy-7.1 o latest. No se puede combinar con texture_image_url ni con texture_prompt.

Name
should_remesh
Type
boolean
predeterminado false (Meshy 6 and Meshy 7 models), true (others)
Description
Controla si se habilita la fase de remallado. Para obtener el modelo de mayor calidad, recomendamos establecer should_remesh en false.

Solo aplica cuando should_remesh = true

Name
topology
Type
string
predeterminado triangle
Description
Especifica el topology del modelo generado.
Valores disponibles:
- quad: genera una malla predominantemente de cuadriláteros.
- triangle: genera una malla de triángulos decimada.
Name
target_polycount
Type
integer
predeterminado 30,000
Description
Especifica el número objetivo de polígonos en el modelo generado. El número real de polígonos puede desviarse del objetivo según la complejidad de la geometría.
El rango de valores válido varía según el nivel de usuario:
- De 100 a 300,000 (inclusive)
Name
decimation_mode
Type
integer
Description
Habilita la decimación adaptativa estableciendo un nivel de recuento de polígonos. Cuando se establece, se ignora target_polycount.
Valores disponibles:
- 1: Adaptativo — recuento de polígonos ultra.
- 2: Adaptativo — recuento de polígonos alto.
- 3: Adaptativo — recuento de polígonos medio.
- 4: Adaptativo — recuento de polígonos bajo.
Name
save_pre_remeshed_model
Type
boolean
predeterminado false
Description
Cuando se establece en true, Meshy también almacena un archivo GLB adicional antes de que finalice la fase de remallado.

Name
symmetry_mode
Type
string
⚠ obsoleto
predeterminado auto
Description
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: impone la simetría durante la generación.
Name
pose_mode
Type
string
predeterminado ""
Description
Especifica 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 ninguna pose específica.
Name
is_a_t_pose
Type
boolean
⚠ obsoleto
predeterminado false
Description
Usa pose_mode en su lugar. Indica si se debe generar el modelo en una pose A/T.
Name
image_enhancement
Type
boolean
predeterminado true
Description
Optimiza las imágenes de entrada para obtener mejores resultados. Establécelo en false para conservar la apariencia exacta de las imágenes de entrada sin ningún procesamiento de estilo.
Solo compatible cuando ai_model es meshy-6, meshy-7.1 o latest.
Name
remove_lighting
Type
boolean
predeterminado true
Description
Elimina los reflejos y las sombras de la textura de color base, lo que produce un resultado más limpio que funciona mejor con configuraciones de iluminación personalizadas.
Solo compatible cuando ai_model es meshy-6, meshy-7.1 o latest.
Name
moderation
Type
boolean
predeterminado false
Description
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 pasará a la fase de generación.
Se examinarán cada imagen de image_urls y el texto de texture_prompt.
Name
target_formats
Type
string[]
Description
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.
Valores disponibles: glb, obj, fbx, stl, usdz, 3mf
Cuando se omite, se generan todos los formatos excepto 3mf. 3mf solo se incluye cuando se especifica explícitamente.
Name
auto_size
Type
boolean
predeterminado false
Description
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 se establezca explícitamente origin_at.
Name
alpha_thumbnail
Type
boolean
predeterminado false
Description
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.
Name
multi_view_thumbnails
Type
boolean
predeterminado false
Description
Cuando se establece en true, la tarea renderiza además cuatro miniaturas de vistas cardinales (frontal, derecha, trasera, izquierda) y las devuelve en thumbnail_urls en la respuesta GET. El campo thumbnail_url existente no cambia y sigue apuntando a la vista frontal, por lo que los clientes existentes no se ven afectados.
Agrega aproximadamente 3 segundos a la latencia de la tarea.

Solo aplica cuando auto_size = true

Name
origin_at
Type
string
predeterminado bottom
Description
Posición del origen cuando auto_size está habilitado. Valores disponibles: bottom, center.

Devuelve

La propiedad result de la respuesta contiene el id de la tarea Multi-imagen a 3D recién creada.

Modos de fallo

Name
400 - Bad Request
Description
La solicitud no era aceptable. Causas comunes:
- Parámetro faltante: se debe proporcionar image_urls o input_task_id.
- Tarea de entrada no válida: input_task_id debe referirse a una tarea Texto a imagen, Imagen a imagen o de variante multivista con estado SUCCEEDED.
- Cantidad de imágenes no válida: image_urls debe contener entre 1 y 4 imágenes, y texture_image_urls entre 1 y 4.
- Formato de imagen no válido: una o más imágenes en image_urls no tienen formatos compatibles.
- Entradas de textura en conflicto: texture_image_urls no se puede combinar con texture_image_url ni con texture_prompt, y requiere should_texture: true.
- Modelo no compatible con textura multivista: texture_image_urls requiere ai_model meshy-7.1 o latest.
- URL inaccesible: no se pudo descargar uno o más elementos de image_urls o texture_image_urls.
- Imagen demasiado grande: una o más imágenes de image_urls, texture_image_url o texture_image_urls superan los 20 MB.
- Resolución no compatible para entrada multi-imagen: geometry_resolution: "4k" no está disponible en este endpoint; usa 2k o standard.
Name
401 - Unauthorized
Description
Error de autenticación. Verifica tu clave de API.
Name
402 - Payment Required
Description
Créditos insuficientes para realizar esta tarea.
Name
429 - Too Many Requests
Description
Has excedido tu límite de tasa.

Request

POST

/openapi/v1/multi-image-to-3d

# Simple request
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ]
  }'

# With Ultra 2K geometry, PBR texturing and GLB format
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>",
      "<your second publicly accessible image url or base64-encoded data URI>"
    ],
    "ai_model": "meshy-7.1",
    "geometry_resolution": "2k",
    "should_texture": true,
    "enable_pbr": true,
    "target_formats": ["glb"]
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

GET/openapi/v1/multi-image-to-3d/:id

Recuperar una tarea de Multi-imagen a 3D

Este endpoint le permite recuperar una tarea de Multi-imagen a 3D dado un id de tarea válido. Consulte El objeto de tarea de Multi-imagen a 3D para ver qué propiedades se incluyen con el objeto de tarea de Multi-imagen a 3D.

Parámetros

Name
id
Type
path
Description
Identificador único de la tarea de Multi-imagen a 3D que se desea recuperar.

Devuelve

La respuesta contiene el objeto de tarea de Multi-imagen a 3D. Consulte la sección El objeto de tarea de Multi-imagen a 3D para más detalles.

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

DELETE/openapi/v1/multi-image-to-3d/:id

Eliminar una tarea de Multi-imagen a 3D

Este endpoint elimina permanentemente una tarea de Multi-imagen a 3D, incluyendo todos los modelos y datos asociados. Esta acción es irreversible.

Parámetros de ruta

Name
id
Type
path
Description
El ID de la tarea de Multi-imagen a 3D que se va a eliminar.

Estado de la tarea

Una tarea que todavía está en PENDING se elimina y los créditos consumidos en el momento de la creación se reembolsan.

Una tarea que ya está IN_PROGRESS no se puede eliminar: la solicitud se rechaza con 409 Conflict y la tarea sigue en ejecución. Los créditos de una tarea que el worker ya ha comenzado no son reembolsables, por lo que eliminarla a mitad de ejecución te costaría tanto los créditos como el resultado. Espera a que alcance el estado SUCCEEDED, FAILED o CANCELED, y luego elimínala.

Una tarea en un estado terminal (SUCCEEDED, FAILED o CANCELED) se elimina sin reembolso.

Devuelve

Devuelve 200 OK en caso de éxito, o 409 Conflict cuando la tarea está en IN_PROGRESS.

Request

DELETE

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS — the task is left running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

GET/openapi/v1/multi-image-to-3d

List Multi-Image to 3D Tasks

Este endpoint le permite recuperar una lista de tareas de Multi-imagen a 3D.

Parámetros

Atributos opcionales

Name
page_num
Type
integer
Description
Número de página para la paginación. Comienza y toma como valor predeterminado 1.
Name
page_size
Type
integer
Description
Límite del tamaño de página. El valor predeterminado es 10 elementos. El máximo permitido es 100 elementos.
Name
sort_by
Type
string
Description
Campo por el cual ordenar. Valores disponibles:
- +created_at: Ordenar por fecha de creación en orden ascendente.
- -created_at: Ordenar por fecha de creación en orden descendente.

Devuelve

Devuelve una lista paginada de Los objetos de tarea de Multi-imagen a 3D.

Request

GET

/openapi/v1/multi-image-to-3d

curl https://api.meshy.ai/openapi/v1/multi-image-to-3d?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "multi-image-to-3d",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
      "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
      "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
      "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
      "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
    "thumbnail_urls": {
      "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
      "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
      "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
      "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
    },
    "texture_prompt": "",
    "progress": 100,
    "started_at": 1692771667037,
    "created_at": 1692771650657,
    "expires_at": 1692771679037,
    "finished_at": 1692771669037,
    "status": "SUCCEEDED",
    "texture_urls": [
      {
        "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
        "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
        "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
        "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
        "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 30
  }
]

GET/openapi/v1/multi-image-to-3d/:id/stream

Transmitir una tarea de Multi-imagen a 3D

Este endpoint transmite actualizaciones en tiempo real para una tarea de Multi-imagen a 3D utilizando Server-Sent Events (SSE).

Parámetros

Name
id
Type
path
Description
Identificador único de la tarea de Multi-imagen a 3D a transmitir.

Devuelve

Devuelve un flujo de objetos de tarea de Multi-imagen a 3D como Server-Sent Events.

Para las tareas PENDING o IN_PROGRESS, el flujo de respuesta solo incluirá los campos necesarios progress y status.

Request

GET

/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
  "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
  "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
  "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
  "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
  "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
  "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
  "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
  "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
  "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
  "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

El objeto de tarea de Multi-imagen a 3D

El objeto de tarea de Multi-imagen a 3D es una unidad de trabajo que Meshy monitorea para generar un modelo 3D a partir de múltiples imágenes (entre 1 y 4 inclusive). Las imágenes deben ser del mismo objeto, idealmente desde diferentes vistas o ángulos. El objeto tiene las siguientes propiedades:

Propiedades

Name
id
Type
string
Description
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.
Name
type
Type
string
Description
Tipo de la tarea de Multi-imagen a 3D. El valor es multi-image-to-3d.
Name
model_urls
Type
object
Description
URL descargable al 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.
- Name
  glb
  Type
  string
  Description
  URL descargable al archivo GLB.
- Name
  fbx
  Type
  string
  Description
  URL descargable al archivo FBX.
- Name
  obj
  Type
  string
  Description
  URL descargable al archivo OBJ.
- Name
  usdz
  Type
  string
  Description
  URL descargable al archivo USDZ.
- Name
  mtl
  Type
  string
  Description
  URL descargable al archivo MTL, devuelto junto con las exportaciones OBJ cuando hay texturas presentes.
- Name
  stl
  Type
  string
  Description
  URL descargable al archivo STL.
- Name
  3mf
  Type
  string
  Description
  URL descargable al archivo 3MF. Solo está presente cuando se solicitó 3mf a través de target_formats.
- Name
  pre_remeshed_glb
  Type
  string
  Description
  URL descargable al resultado GLB original antes del remesh.
  Disponible solo cuando la tarea se creó con should_remesh: true y save_pre_remeshed_model: true.
Name
thumbnail_url
Type
string
Description
URL descargable a la imagen en miniatura del archivo del modelo. Equivalente a thumbnail_urls.front cuando está presente, se mantiene por compatibilidad con versiones anteriores.
Name
alpha_thumbnail_url
Type
string
Description
URL descargable a 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.
Name
thumbnail_urls
Type
object
Description
URLs descargables para cuatro miniaturas de vista cardinal del modelo 3D generado. Cada valor es una URL firmada a un PNG de 512×512 renderizado con los mismos materiales e iluminación que thumbnail_url. Útil para previsualizar el modelo desde múltiples ángulos en flujos de procesamiento por lotes sin descargar el GLB.
Solo está presente cuando la tarea se creó con multi_view_thumbnails: true y ha alcanzado el estado SUCCEEDED. Las tareas más antiguas y las tareas creadas sin esta opción no incluirán este campo.
- Name
  front
  Type
  string
  Description
  Vista frontal, rotación de 0° alrededor del eje vertical (coincide con thumbnail_url).
- Name
  right
  Type
  string
  Description
  Vista derecha, rotación de 90°.
- Name
  back
  Type
  string
  Description
  Vista posterior, rotación de 180°.
- Name
  left
  Type
  string
  Description
  Vista izquierda, rotación de 270°.
Name
texture_prompt
Type
string
Description
El prompt de texto que se utilizó para guiar el proceso de texturizado.
Name
texture_image_urls
Type
string[]
Description
URLs descargables a las imágenes de referencia de textura que se utilizaron para crear la tarea, en el orden en que se proporcionaron. Solo está presente cuando la tarea se creó con texture_image_urls.
Name
ultra_mode
Type
boolean
⚠ obsoleto
Description
Obsoleto; lee geometry_resolution en su lugar.
Name
geometry_resolution
Type
string
Description
El nivel Ultra en el que se ejecutó la tarea (2k); se omite para standard.
Name
progress
Type
integer
Description
Progreso de la tarea. Si la tarea aún no se ha iniciado, esta propiedad será 0. Una vez que la tarea se haya completado con éxito, esto se convertirá en 100.
Name
started_at
Type
timestamp
Description
Marca de tiempo de cuándo se inició la tarea, en milisegundos. Si la tarea aún no se ha iniciado, esta propiedad será 0.
Una marca de tiempo representa la cantidad de milisegundos transcurridos desde el 1 de enero de 1970 UTC, siguiendo el estándar RFC 3339. Por ejemplo, el viernes 1 de septiembre de 2023 a las 12:00:00 PM GMT se representa como 1693569600000. Esto aplica a todas las marcas de tiempo en Meshy API.
Name
created_at
Type
timestamp
Description
Marca de tiempo de cuándo se creó la tarea, en milisegundos.
Name
expires_at
Type
timestamp
Description
Marca de tiempo de cuándo expira el resultado de la tarea, en milisegundos.
Name
finished_at
Type
timestamp
Description
Marca de tiempo de cuándo finalizó la tarea, en milisegundos. Si la tarea aún no ha finalizado, esta propiedad será 0.
Name
status
Type
string
Description
Estado de la tarea. Los valores posibles son uno de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
texture_urls
Type
array
Description
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:
- Name
  base_color
  Type
  string
  Description
  URL descargable a la imagen del mapa de color base.
- Name
  metallic
  Type
  string
  Description
  URL descargable a la imagen del mapa metálico.
  Si la tarea se crea con enable_pbr: false, esta propiedad se omitirá.
- Name
  normal
  Type
  string
  Description
  URL descargable a la imagen del mapa de normales.
  Si la tarea se crea con enable_pbr: false, esta propiedad se omitirá.
- Name
  roughness
  Type
  string
  Description
  URL descargable a la imagen del mapa de rugosidad.
  Si la tarea se crea con enable_pbr: false, esta propiedad se omitirá.
- Name
  emission
  Type
  string
  Description
  URL descargable a la imagen del mapa de emisión.
  Si la tarea se crea con enable_pbr: false, o ai_model es meshy-6-lite, esta propiedad se omitirá.
Name
preceding_tasks
Type
integer
Description
El recuento de tareas precedentes.
El valor de este campo solo es significativo si el estado de la tarea es PENDING.
Name
task_error
Type
object
Description
Detalles del error para tareas fallidas. Consulta Errores para la referencia completa del objeto task_error.
Name
consumed_credits
Type
integer
Description
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).

Example Multi-Image to 3D Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "multi-image-to-3d",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
    "usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
    "pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
  "thumbnail_urls": {
    "front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
    "right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
    "back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
    "left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
  },
  "texture_prompt": "",
  "progress": 100,
  "started_at": 1692771667037,
  "created_at": 1692771650657,
  "expires_at": 1692771679037,
  "finished_at": 1692771669037,
  "status": "SUCCEEDED",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
      "normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
      "roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX",
      "emission": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30,
}