API de Multi-imagen a 3D

Genera un modelo 3D a partir de una a cuatro imágenes del mismo objeto, tomadas desde diferentes ángulos.

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

Crear una tarea de Multi-imagen a 3D

Crea una tarea de Multi-imagen a 3D. La tarea se ejecuta en segundo plano. Para saber cuánto suele tardar una tarea, consulta Tiempos de procesamiento. Para conocer los campos que tiene una tarea, consulta El objeto de tarea de Multi-imagen a 3D.

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"
}

Parámetros

Name
input_task_id
Type
string
Requerido
Description
Obligatorio a menos que envíes image_urls. El ID de una tarea de Texto a imagen o Imagen a imagen, incluida una multivista. Meshy usa entre una y cuatro de sus imágenes como entrada. La tarea debe ser una que hayas creado con la API y tener el estado SUCCEEDED.

Name
image_urls
Type
array
Requerido
Description
Obligatorio a menos que envíes input_task_id. De una a cuatro imágenes, cada una como una URL pública o un Data URI, como data:image/jpeg;base64,<tus datos de imagen codificados en base64>. Si envías ambos, Meshy usa input_task_id.
Cada imagen debe ser un archivo .jpg, .jpeg, .png o .webp de un máximo de 20 MB. Más de cuatro imágenes devuelve 400.
Para obtener los mejores resultados, las imágenes deben mostrar el mismo objeto desde diferentes ángulos. Con meshy-7.1 o latest, Meshy usa la primera imagen como la vista frontal, y el orden de las demás no importa.

Name
ai_model
Type
string
predeterminado latest
Description
El modelo de IA que genera el modelo 3D.
Valores disponibles:
- latest: Meshy 7.1
- meshy-7.1
- meshy-6
- meshy-6-lite
- meshy-7: obsoleto, envía meshy-7.1 en su lugar
Name
geometry_resolution
Type
string
predeterminado standard
Description
Cuánto detalle de geometría generar.
Valores disponibles:
- standard
- 2k: ejecuta la pasada Ultra a 2048³. Necesita meshy-7.1, latest, o el obsoleto meshy-7.
Name
ultra_mode
Type
boolean
⚠ obsoleto
predeterminado false
Description
Envía geometry_resolution en su lugar. ultra_mode: true es lo mismo que geometry_resolution: "2k".
Name
should_texture
Type
boolean
predeterminado true
Description
Si se deben generar texturas. true devuelve un modelo con textura, y false omite el paso de textura y devuelve una malla sin texturas.

Solo aplica cuando should_texture = true

Name
enable_pbr
Type
boolean
predeterminado false
Description
Si se deben generar también mapas metálico, de rugosidad y normal, además del color base. Con meshy-6, Meshy también genera un mapa de emisión, excepto en texture_resolution: 8k. Los demás modelos no generan un mapa de emisión.
Name
texture_resolution
Type
string
predeterminado 2k
Description
El tamaño de la textura de color base. Un tamaño mayor captura más detalle de superficie.
Valores disponibles:
- 2k: 2048×2048
- 4k: 4096×4096
- 8k: 8192×8192
4k y 8k necesitan meshy-6, meshy-7.1, o latest. En 8k, Meshy no genera un mapa de emisión.
Name
hd_texture
Type
boolean
⚠ obsoleto
predeterminado false
Description
Envía texture_resolution en su lugar. hd_texture: true es lo mismo que texture_resolution: "4k". Si envías ambos, Meshy usa texture_resolution.
Name
texture_prompt
Type
string
Description
Texto que guía la textura, de hasta 800 caracteres. Un texto más largo devuelve 400.
Name
texture_image_url
Type
string
Description
Una imagen 2D que guía la textura, como una URL pública o un Data URI, como data:image/jpeg;base64,<tus datos de imagen codificados en base64>. La imagen debe ser un archivo .jpg, .jpeg, .png o .webp de un máximo de 20 MB.
Si envías tanto texture_image_url como texture_prompt, Meshy usa texture_prompt.
La textura podría no salir bien cuando la forma de la imagen difiere mucho del modelo 3D.
Name
texture_image_urls
Type
string[]
Description
De una a cuatro imágenes del objeto desde diferentes vistas que guían la textura. Meshy usa la primera imagen como la vista frontal. El orden de las demás vistas (izquierda, trasera, derecha) no importa.
Cada imagen sigue las mismas reglas que texture_image_url. Es una URL pública o un Data URI, en formato .jpg, .jpeg, .png o .webp, de un máximo de 20 MB.
Estas imágenes solo guían la textura y no dependen de image_urls. Las dos listas pueden contener imágenes diferentes y un número diferente de imágenes.
texture_image_urls necesita meshy-7.1, latest, o el obsoleto meshy-7. No puedes enviarlo junto con texture_image_url o texture_prompt.

Name
should_remesh
Type
boolean
predeterminado true (meshy-6-lite), false (other models)
Description
Si se debe remallar el modelo después de la generación. Para obtener el modelo 3D de mayor calidad, configúralo en false.

Solo aplica cuando should_remesh = true

Name
topology
Type
string
predeterminado triangle
Description
El tipo de cara del modelo remallado.
Valores disponibles:
- quad: una malla predominantemente de cuadriláteros
- triangle: una malla de triángulos decimada
Name
target_polycount
Type
integer
predeterminado 30000
Description
El número de caras objetivo, de 100 a 300000. El resultado puede diferir del objetivo, dependiendo de la geometría del modelo. Un valor fuera del rango devuelve 400.
Name
decimation_mode
Type
integer
Description
Recuento de caras adaptativo, por nivel. Cuando lo configuras, Meshy ignora target_polycount.
Valores disponibles:
- 1: ultra
- 2: alto
- 3: medio
- 4: bajo
Name
save_pre_remeshed_model
Type
boolean
predeterminado false
Description
Si se debe guardar también el GLB de antes del remallado, devuelto en model_urls.pre_remeshed_glb.

Name
symmetry_mode
Type
string
⚠ obsoleto
predeterminado auto
Description
Omítelo. No afecta la salida.
Valores disponibles:
- off: sin simetría
- auto: simetría basada en la geometría de entrada
- on: simetría forzada
Name
pose_mode
Type
string
predeterminado ""
Description
La pose del modelo generado.
Valores disponibles:
- a-pose: una pose A
- t-pose: una pose T
- "" (cadena vacía): sin pose específica
Name
is_a_t_pose
Type
boolean
⚠ obsoleto
predeterminado false
Description
Envía pose_mode en su lugar. Si se debe generar el modelo en una pose A o T.
Name
image_enhancement
Type
boolean
predeterminado true
Description
Si se deben optimizar las imágenes de entrada antes de generar. false conserva el aspecto exacto de las imágenes de entrada, sin procesamiento de estilo. Solo compatible con meshy-6, meshy-7.1, o latest. Enviarlo con meshy-6-lite devuelve 400.
Name
remove_lighting
Type
boolean
predeterminado true
Description
Si se deben quitar los brillos y las sombras de la textura de color base. El resultado más limpio funciona mejor con tu propia iluminación. Solo meshy-6 lo usa. meshy-7, meshy-7.1 y latest lo aceptan y lo ignoran. En texture_resolution: 8k, Meshy siempre elimina la iluminación. Enviarlo con meshy-6-lite devuelve 400.
Name
moderation
Type
boolean
predeterminado false
Description
Si se deben examinar las entradas en busca de contenido dañino. Meshy examina cada imagen de entrada, texture_image_url o cada imagen en texture_image_urls, y el texto en texture_prompt. Si Meshy encuentra contenido dañino, la solicitud devuelve 400 y Meshy no crea una tarea.
Name
target_formats
Type
string[]
Description
Los formatos de archivo 3D que se van a generar. Meshy genera y devuelve solo los formatos que enumeres, lo que puede acortar la tarea.
Valores disponibles:
- glb
- obj
- fbx
- stl
- usdz
- 3mf
Si lo omites, Meshy genera todos los formatos excepto 3mf. Meshy genera 3mf solo cuando lo incluyes.
Name
auto_size
Type
boolean
predeterminado false
Description
Si se debe estimar la altura real del objeto con visión de IA y redimensionar el modelo a esa altura. Meshy coloca el origen en la parte inferior a menos que configures origin_at.

Solo aplica cuando auto_size = true

Name
origin_at
Type
string
predeterminado bottom
Description
Dónde colocar el origen del modelo, bottom o center.

Name
alpha_thumbnail
Type
boolean
predeterminado false
Description
Si se debe renderizar también una vista previa con fondo transparente (RGBA), devuelta en alpha_thumbnail_url cuando obtienes la tarea. thumbnail_url no cambia.
Name
multi_view_thumbnails
Type
boolean
predeterminado false
Description
Si se deben renderizar también vistas previas frontal, derecha, trasera e izquierda, devueltas en thumbnail_urls cuando obtienes la tarea. thumbnail_url no cambia y sigue mostrando la vista frontal. Esto añade unos 5 segundos a la tarea.

Resultados

El campo result de la respuesta contiene el ID de la nueva tarea de Multi-imagen a 3D.

Modos de error

Name
400 - Bad Request
Description
La solicitud no se puede ejecutar. El mensaje de error indica qué problema encontró. Por ejemplo:
- Parámetro faltante: No se envió ni image_urls ni input_task_id.
- Tarea de entrada inválida: input_task_id no es una tarea de Texto a imagen o Imagen a imagen con estado SUCCEEDED, ni una multivista.
- Cantidad de imágenes inválida: image_urls o texture_image_urls no contiene entre 1 y 4 imágenes.
- Formato de imagen inválido: Una imagen en image_urls no está en un formato compatible.
- Entradas de textura en conflicto: texture_image_urls se envió junto con texture_image_url, con texture_prompt, o con should_texture: false.
- Modelo no compatible para textura multivista: texture_image_urls se envió con meshy-6 o meshy-6-lite.
- URL inaccesible: Meshy no puede descargar una imagen en image_urls o texture_image_urls.
- Imagen demasiado grande: Una imagen en image_urls, texture_image_url, o texture_image_urls supera los 20 MB.
- Resolución no compatible para entrada multiimagen: geometry_resolution es "4k", lo cual este endpoint no admite. Usa 2k o standard.
- Modelo no compatible para opciones de imagen: image_enhancement o remove_lighting se envió con ai_model: "meshy-6-lite".
Corrige la solicitud y vuelve a enviarla. Consulta Errores.
Name
401 - Unauthorized
Description
Falta la clave de API o no es válida. Comprueba el encabezado Authorization.
Name
402 - Payment Required
Description
Por ejemplo:
- Créditos insuficientes: La cuenta no tiene créditos suficientes para esta tarea, o la cuenta alcanzó un límite de créditos. Comprueba tu saldo de créditos y vuelve a intentarlo.
- Plan gratuito: Crear una tarea requiere un plan de pago. Mejora tu plan en la configuración de tu suscripción y vuelve a intentarlo.
Name
404 - Not Found
Description
input_task_id no coincide con ninguna de tus tareas. Comprueba el ID de la tarea y vuelve a enviar la solicitud.
Name
429 - Too Many Requests
Description
Superaste tu límite de tasa. Espera y vuelve a intentarlo. Consulta Límites de tasa.

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

Obtener una tarea de Multi-imagen a 3D

Devuelve una tarea de Multi-imagen a 3D por su ID.

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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

Parámetros

Name
id
Type
path
Description
El ID de la tarea de la respuesta de creación.

Devuelve

El objeto de tarea de Multi-imagen a 3D.

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

Eliminar una tarea de Multi-imagen a 3D

Elimina permanentemente una tarea de Multi-imagen a 3D, incluidos sus modelos y datos. No puedes deshacer una eliminación.

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 keeps 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."
}

Parámetros de ruta

Name
id
Type
path
Description
El ID de la tarea a eliminar.

Estado de la tarea

Eliminar una tarea en estado PENDING reembolsa los créditos que usó al crearla.

Una tarea IN_PROGRESS no se puede eliminar. La solicitud devuelve 409 Conflict, y la tarea sigue ejecutándose. Meshy no reembolsa una tarea que ya ha comenzado, así que eliminarla te costaría tanto los créditos como el resultado. Espera a que alcance el estado SUCCEEDED, FAILED o CANCELED, y luego elimínala.

Eliminar una tarea en un estado final (SUCCEEDED, FAILED o CANCELED) no reembolsa sus créditos.

Devuelve

200 OK cuando la tarea se elimina, o 409 Conflict cuando la tarea está IN_PROGRESS.

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

List Multi-Image to 3D tasks

Devuelve una lista de tus tareas 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"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 30
  }
]

Parámetros

Name
page_num
Type
integer
predeterminado 1
Description
El número de página a devolver, empezando en 1.
Name
page_size
Type
integer
predeterminado 10
Description
El número de tareas por página, hasta 100.
Name
sort_by
Type
string
Description
El orden de clasificación.
Valores disponibles:
- +created_at: más antiguas primero
- -created_at: más recientes primero

Devuelve

Una lista paginada de objetos de tarea de Multi-imagen a 3D.

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

Transmitir una tarea de Multi-imagen a 3D

Transmite las actualizaciones de una tarea de Multi-imagen a 3D como eventos enviados por el servidor (Server-Sent Events, SSE).

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.
// These examples are shortened. Each event holds the full task object.
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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

Parámetros

Name
id
Type
path
Description
El ID de la tarea proveniente de la respuesta de creación.

Devuelve

Un flujo de objetos de tarea de Multi-imagen a 3D como eventos enviados por el servidor.

Cada evento contiene el objeto de tarea completo, con la misma forma que devuelve el endpoint Get. Mientras la tarea esté en PENDING o IN_PROGRESS, sus campos de resultado aún no tienen valores.

El objeto de tarea Multi-imagen a 3D

Un objeto de tarea Multi-imagen a 3D describe una generación de un modelo 3D a partir de una a cuatro imágenes de un objeto. Contiene el estado, el progreso y los archivos del modelo cuando la tarea tiene éxito.

Propiedades

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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 30
}

Name
id
Type
string
Description
El ID de la tarea. Trátalo como una cadena opaca y no dependas de su formato.
Name
type
Type
string
Description
El tipo de tarea, siempre multi-image-to-3d.
Name
model_urls
Type
object
Description
URLs de descarga para el modelo 3D generado, una por cada formato de archivo. Un formato que la tarea no generó no tiene clave, en lugar de una cadena vacía.
- Name
  glb
  Type
  string
  Description
  El archivo GLB.
- Name
  fbx
  Type
  string
  Description
  El archivo FBX.
- Name
  obj
  Type
  string
  Description
  El archivo OBJ.
- Name
  usdz
  Type
  string
  Description
  El archivo USDZ.
- Name
  mtl
  Type
  string
  Description
  El archivo MTL, devuelto junto con el archivo OBJ cuando el modelo tiene texturas.
- Name
  stl
  Type
  string
  Description
  El archivo STL.
- Name
  3mf
  Type
  string
  Description
  El archivo 3MF. Presente solo cuando target_formats incluye 3mf.
- Name
  pre_remeshed_glb
  Type
  string
  Description
  El archivo GLB previo al remallado. Presente solo cuando creaste la tarea con should_remesh: true y save_pre_remeshed_model: true al mismo tiempo.
Name
thumbnail_url
Type
string
Description
URL de descarga para una imagen de vista previa del modelo. Es la misma que thumbnail_urls.front cuando ese campo está presente.
Name
alpha_thumbnail_url
Type
string
Description
URL de descarga para una versión de thumbnail_url con fondo transparente (RGBA). Presente solo cuando creaste la tarea con alpha_thumbnail: true y Meshy renderizó la vista previa transparente.
Name
thumbnail_urls
Type
object
Description
URLs de descarga para vistas previas del modelo 3D desde cuatro lados. Cada una es una URL firmada a un PNG de 512×512, renderizado con los mismos materiales e iluminación que thumbnail_url. Puedes usarlas para previsualizar el modelo desde varios ángulos sin descargar el GLB.
Presente solo cuando creaste la tarea con multi_view_thumbnails: true y la tarea alcanzó SUCCEEDED. Una tarea creada sin multi_view_thumbnails: true no tiene este campo.
- Name
  front
  Type
  string
  Description
  La vista frontal, a 0° alrededor del eje vertical. Coincide con thumbnail_url.
- Name
  right
  Type
  string
  Description
  La vista derecha, a 90°.
- Name
  back
  Type
  string
  Description
  La vista trasera, a 180°.
- Name
  left
  Type
  string
  Description
  La vista izquierda, a 270°.
Name
texture_prompt
Type
string
Description
El prompt de texto que guió la textura.
Name
texture_image_urls
Type
string[]
Description
URLs de descarga para las imágenes de referencia de textura con las que creaste la tarea, en el orden en que las enviaste. Presente solo cuando creaste la tarea con texture_image_urls.
Name
ultra_mode
Type
boolean
⚠ obsoleto
Description
Consulta geometry_resolution en su lugar.
Name
geometry_resolution
Type
string
Description
El nivel Ultra en el que se ejecutó la tarea, que es 2k. Una tarea standard no tiene este campo.
Name
progress
Type
integer
Description
Cuánto se ha completado de la tarea, como porcentaje. Es 0 hasta que la tarea comienza y 100 cuando tiene éxito.
Name
started_at
Type
timestamp
Description
Momento en que comenzó la tarea, en milisegundos Unix. Es 0 hasta que la tarea comienza.
Name
created_at
Type
timestamp
Description
Momento en que se creó la tarea, en milisegundos Unix.
Name
expires_at
Type
timestamp
Description
Momento en que expiran los resultados de la tarea, en milisegundos Unix.
Name
finished_at
Type
timestamp
Description
Momento en que finalizó la tarea, en milisegundos Unix. Es 0 hasta que la tarea finaliza.
Name
status
Type
string
Description
El estado de la tarea, uno de PENDING, IN_PROGRESS, SUCCEEDED, FAILED o CANCELED.
Name
texture_urls
Type
array
Description
URLs de descarga para los mapas de textura que generó la tarea, como un arreglo de objetos. Normalmente contiene un objeto. Cada objeto tiene estos campos:
- Name
  base_color
  Type
  string
  Description
  El mapa de color base.
- Name
  metallic
  Type
  string
  Description
  El mapa metálico. No se incluye cuando creaste la tarea con enable_pbr: false.
- Name
  normal
  Type
  string
  Description
  El mapa de normales. No se incluye cuando creaste la tarea con enable_pbr: false.
- Name
  roughness
  Type
  string
  Description
  El mapa de rugosidad. No se incluye cuando creaste la tarea con enable_pbr: false.
- Name
  emission
  Type
  string
  Description
  El mapa de emisión. Se incluye solo cuando creaste la tarea con ai_model: meshy-6 y enable_pbr: true, con texture_resolution de 2k o 4k.
Name
preceding_tasks
Type
integer
Description
El número de tareas por delante de esta en la cola. El valor solo es significativo mientras la tarea está PENDING.
Name
task_error
Type
object
Description
Los detalles del error cuando la tarea falla. Consulta Errores.
Name
consumed_credits
Type
integer
Description
El número de créditos que usó la tarea. Presente cuando el estado es PENDING, IN_PROGRESS o SUCCEEDED. Es 0 para una tarea FAILED, porque Meshy reembolsa los créditos cuando una tarea falla.