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.
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 Multi-imagen a 3D.
Request
# 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"]
}'
# Textured with Meshy N1 from the input images, the first as the front view
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 front view image url or base64-encoded data URI>",
"<your back view image url or base64-encoded data URI>"
],
"ai_model": "meshy-7.1",
"texture_model": "meshy-n1"
}'
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 de Imagen a imagen, incluida una de tipo multivista. Meshy usa sus una a cuatro imágenes como entrada. La tarea debe ser una que hayas creado con la API y que tenga el estadoSUCCEEDED.
- 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, comodata:image/jpeg;base64,<tus datos de imagen codificados en base64>. Si envías ambos, Meshy usainput_task_id.Cada imagen debe ser un archivo
.jpg,.jpeg,.pngo.webpde un máximo de 20 MB, al menos 32 píxeles en cada lado, y un máximo de 178.956.970 píxeles (ancho × alto). Más de cuatro imágenes devuelve400.Para obtener los mejores resultados, las imágenes deben mostrar el mismo objeto desde distintos ángulos. Con
meshy-7.1olatest, 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.1meshy-7.1meshy-6meshy-6-litemeshy-7: obsoleto, envíameshy-7.1en su lugar. Se retira el 31 de diciembre de 2026.
Consulta Modelos para saber qué modelo se adapta a tu proyecto, como un objeto real o una impresión 3D.
- Name
- geometry_resolution
- Type
- string
- predeterminado standard
- Description
Cuánto detalle de geometría generar.
Valores disponibles:
standard2k: ejecuta el paso Ultra a 2048³. Requieremeshy-7.1,latest, o el obsoletomeshy-7.
- Name
- ultra_mode
- Type
- boolean
- ⚠ obsoleto
- predeterminado false
- Description
Envía
geometry_resolutionen su lugar.ultra_mode: truees lo mismo quegeometry_resolution: "2k".
- Name
- should_texture
- Type
- boolean
- predeterminado true
- Description
Si se deben generar texturas.
truedevuelve un modelo texturizado, yfalseomite el paso de texturizado y devuelve una malla sin texturas.
should_texture = true- Name
- texture_model
- Type
- string
- predeterminado depends on ai_model
- Description
El modelo de IA que texturiza el modelo 3D desde varias vistas, en la misma tarea. Omítelo para usar el modelo de textura predeterminado de tu
ai_model. No cambia el costo en créditos.Valores disponibles:
meshy-7: Meshy 7, con mapas PBR y texturas de hasta 8Kmeshy-n1: Meshy N1, una textura de color base de 2K solo a partir de imágenes de referencia
Todos los
ai_modeladmiten ambos. Una solicitud texturizada conmeshy-6omeshy-6-litedevuelve400, al igual que una opción que el modelo de textura elegido no admite. Conshould_texture: false, Meshy ignoratexture_model, pero un valor desconocido igual devuelve400.Con
meshy-n1, Meshy texturiza a partir detexture_image_urlsotexture_image_url, o de las imágenes de entrada cuando no envías ninguna de las dos. La primera imagen es la vista frontal. Un modelo generado con más de 7.999.999 triángulos hace fallar la tarea, y Meshy reembolsa sus créditos.Consulta Modelos para saber qué hace cada modelo de textura y cuál elegir.
- Name
- enable_pbr
- Type
- boolean
- predeterminado false
- Description
Si también se deben generar mapas metálicos, de rugosidad y normales, además del color base. El modelo de textura Meshy 6 también genera un mapa de emisión, excepto en
texture_resolution: 8k. Contexture_model: meshy-n1,truedevuelve400.
- 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×20484k: 4096×40968k: 8192×8192
4ky8krequieren el modelo de textura Meshy 7 o Meshy 6, y devuelven400con los demás. En8k, Meshy no genera un mapa de emisión.
- Name
- hd_texture
- Type
- boolean
- ⚠ obsoleto
- predeterminado false
- Description
Envía
texture_resolutionen su lugar.hd_texture: truees lo mismo quetexture_resolution: "4k". Si envías ambos, Meshy usatexture_resolution.
- Name
- texture_prompt
- Type
- string
- Description
Texto que guía la textura, de hasta 800 caracteres. Un texto más largo devuelve
400. Contexture_model: meshy-n1, enviarlo devuelve400.
- 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,.pngo.webpde un máximo de 20 MB, al menos 32 píxeles en cada lado, y un máximo de 178.956.970 píxeles (ancho × alto).Si envías tanto
texture_image_urlcomotexture_prompt, Meshy usatexture_prompt. Contexture_model: meshy-n1, Meshy texturiza a partir de esta imagen como la vista frontal.Es posible que la textura no salga bien cuando la forma en la imagen difiere mucho del modelo 3D.
- Name
- texture_image_urls
- Type
- string[]
- Description
De una a cuatro imágenes del objeto desde distintas vistas que guían la textura. Meshy usa la primera imagen como la vista frontal. El orden de las demás vistas (izquierda, atrás, 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,.pngo.webp, de un máximo de 20 MB, al menos 32 píxeles en cada lado, y un máximo de 178.956.970 píxeles (ancho × alto).Estas imágenes guían solo la textura y no dependen de
image_urls. Las dos listas pueden contener imágenes distintas y un número distinto de imágenes.texture_image_urlsrequiere el modelo de textura Meshy 7 o Meshy N1. Envíalo con uno de estos:ai_modeldemeshy-7.1,latest, o el obsoletomeshy-7texture_modeldemeshy-7omeshy-n1
No puedes enviarlo junto con
texture_image_urlotexture_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 el modelo 3D de mayor calidad, configúralo como
false.
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áterostriangle: una malla triangular diezmada
Con
texture_model: meshy-n1,quaddevuelve400cuando el modelo se remalla, lo cualmeshy-6-litehace de forma predeterminada.
- Name
- target_polycount
- Type
- integer
- predeterminado 30000
- Description
El número de caras objetivo, de
100a300000. El resultado puede diferir del objetivo, según la geometría del modelo. Un valor fuera del rango devuelve400.
- Name
- decimation_mode
- Type
- integer
- Description
Recuento adaptativo de caras, por nivel. Cuando lo configuras, Meshy ignora
target_polycount.Valores disponibles:
1: ultra2: alto3: medio4: bajo
- Name
- save_pre_remeshed_model
- Type
- boolean
- predeterminado false
- Description
Si también se debe guardar 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 el resultado.
Valores disponibles:
off: sin simetríaauto: simetría basada en la geometría de entradaon: simetría forzada
- Name
- pose_mode
- Type
- string
- Description
La pose para un modelo de personaje,
a-poseot-pose. Para no obtener ninguna pose, omitepose_modeyis_a_t_pose.
- Name
- is_a_t_pose
- Type
- boolean
- ⚠ obsoleto
- predeterminado false
- Description
Envía
pose_modeen 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.
falsemantiene el aspecto exacto de las imágenes de entrada, sin procesamiento de estilo. Solo compatible conmeshy-6,meshy-7.1olatest. Enviarlo conmeshy-6-litedevuelve400.
- Name
- remove_lighting
- Type
- boolean
- predeterminado true
- Description
Si se deben eliminar los reflejos y las sombras de la textura de color base. El resultado más limpio funciona mejor bajo tu propia iluminación. Solo el modelo de textura Meshy 6 lo usa, y en
texture_resolution: 8ksiempre elimina la iluminación. Contexture_model: meshy-n1,truedevuelve400. Conai_model: meshy-6-litey su modelo de textura predeterminado, enviarlo devuelve400.
- Name
- moderation
- Type
- boolean
- predeterminado false
- Description
Si se deben filtrar las entradas en busca de contenido dañino. Meshy filtra cada imagen de entrada,
texture_image_urlo cada imagen entexture_image_urls, y el texto entexture_prompt. Si Meshy encuentra contenido dañino, la solicitud devuelve400y Meshy no crea una tarea.
- Name
- target_formats
- Type
- string[]
- Description
Los formatos de archivo 3D a generar. Meshy genera y devuelve solo los formatos que listas, lo que puede acortar la tarea.
Valores disponibles:
glbobjfbxstlusdz3mf
Si lo omites, Meshy genera todos los formatos excepto
3mf. Meshy genera3mfsolo cuando lo listas.
- Name
- auto_size
- Type
- boolean
- predeterminado false
- Description
Si se debe estimar la altura real del objeto en el mundo con visión por IA y redimensionar el modelo a esa altura. Meshy coloca el origen en la parte inferior a menos que configures
origin_at.
auto_size = true- Name
- origin_at
- Type
- string
- predeterminado bottom
- Description
Dónde colocar el origen del modelo,
bottomocenter.
- Name
- alpha_thumbnail
- Type
- boolean
- predeterminado false
- Description
Si también se debe renderizar una vista previa con fondo transparente (RGBA), devuelta en
alpha_thumbnail_urlcuando obtienes la tarea.thumbnail_urlno cambia.
- Name
- multi_view_thumbnails
- Type
- boolean
- predeterminado false
- Description
Si también se deben renderizar vistas previas frontal, derecha, trasera e izquierda, devueltas en
thumbnail_urlscuando obtienes la tarea.thumbnail_urlno cambia y sigue mostrando la vista frontal. Esto añade unos 5 segundos a la tarea.
Devuelve
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_urlsniinput_task_id. - Tarea de entrada no válida:
input_task_idno es una tarea de Texto a imagen o Imagen a imagen con estadoSUCCEEDED, ni una de tipo multivista. - Cantidad de imágenes no válida:
image_urlsotexture_image_urlsno contiene de 1 a 4 imágenes. - Formato de imagen no válido: Una imagen en
image_urlsno tiene un formato compatible. - Entradas de textura en conflicto: Se envió
texture_image_urlsjunto contexture_image_url, contexture_prompt, o conshould_texture: false. - Modelo no compatible con textura multivista: Se envió
texture_image_urlsconai_modeldemeshy-6omeshy-6-lite, a menos quetexture_modelseameshy-7omeshy-n1. - URL inaccesible: Meshy no puede descargar una imagen en
image_urlsotexture_image_urls. - Imagen demasiado grande: Una imagen en
image_urls,texture_image_urlotexture_image_urlssupera los 20 MB. - Tamaño de imagen no válido: Una imagen en
image_urls,texture_image_urlotexture_image_urlstiene un lado más corto de 32 píxeles, o más de 178.956.970 píxeles (ancho × alto). - Resolución no compatible para entrada multi-imagen:
geometry_resolutiones"4k", que este endpoint no admite. Usa2kostandard. - Modelo no compatible con las opciones de imagen: Se envió
image_enhancementconai_model: "meshy-6-lite", o se envióremove_lightingconai_model: "meshy-6-lite"y su modelo de textura predeterminado. - Modelo de textura no válido:
texture_modelno es un nombre de modelo de textura válido. - Modelo de textura no disponible: Una solicitud texturizada envió
texture_modeldemeshy-6omeshy-6-lite. Multi-imagen a 3D solo admite los modelos de textura que texturizan desde varias vistas. Envíameshy-7omeshy-n1, u omitetexture_model. - Opción no compatible con el modelo de textura: La solicitud pide al modelo de textura una opción que no admite, como
enable_pbr: trueconmeshy-n1o una textura4kconmeshy-6-lite. Consulta Modelos.
Corrige la solicitud y envíala de nuevo. Consulta Errores.
- Parámetro faltante: No se envió ni
- Name
401 - Unauthorized- Description
Falta la clave de API o no es válida. Revisa el encabezado
Authorization.
- Name
402 - Payment Required- Description
Por ejemplo:
- Créditos insuficientes: La cuenta no tiene suficientes créditos para esta tarea, o la cuenta alcanzó un límite de créditos. Revisa tu saldo de créditos y vuelve a intentarlo.
- Plan gratuito: Crear una tarea requiere un plan de pago. Actualiza tu plan en la configuración de tu suscripción y vuelve a intentarlo.
- Name
403 - Forbidden- Description
La moderación de contenido bloqueó el prompt o una imagen de entrada. Cambia la entrada y vuelve a intentarlo.
- Name
404 - Not Found- Description
input_task_idno coincide con ninguna de tus tareas. Revisa el ID de la tarea y envía la solicitud de nuevo.
- Name
429 - Too Many Requests- Description
Superaste tu límite de tasa. Espera y vuelve a intentarlo. Consulta Límites de tasa.
Obtener una tarea de Multi-imagen a 3D
Devuelve una tarea de Multi-imagen a 3D según su ID.
Request
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": null,
"consumed_credits": 30
}
Parámetros
- Name
- id
- Type
- path
- Description
El ID de la tarea proveniente de la respuesta de creación.
Devuelve
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
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.
Listar tareas de Multi-imagen a 3D
Devuelve una lista de tus tareas de Multi-imagen a 3D.
Request
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": null,
"consumed_credits": 30
}
]
Parámetros
- Name
- page_num
- Type
- integer
- predeterminado 1
- Description
El número de página a devolver, hasta
255. Un valor mayor devuelve400.
- 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: las más antiguas primero-created_at: las más recientes primero
Devuelve
Una lista paginada de objetos de tarea de Multi-imagen a 3D.
Transmitir una tarea de Multi-imagen a 3D en streaming
Transmite las actualizaciones de una tarea de Multi-imagen a 3D como eventos enviados por el servidor (Server-Sent Events, SSE).
Request
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": null,
"consumed_credits": 30
}
Parámetros
- Name
- id
- Type
- path
- Description
El ID de la tarea proporcionado en 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 estructura que devuelve el endpoint Get. Mientras la tarea esté en estado 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": null,
"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_formatsincluye3mf.
- Name
pre_remeshed_glb- Type
- string
- Description
El archivo GLB previo al remallado. Presente solo cuando creaste la tarea con
should_remesh: trueysave_pre_remeshed_model: truea la vez.
- Name
- thumbnail_url
- Type
- string
- Description
URL de descarga para una imagen de vista previa del modelo. Es la misma que
thumbnail_urls.frontcuando ese campo está presente.
- Name
- alpha_thumbnail_url
- Type
- string
- Description
URL de descarga para una versión de
thumbnail_urlcon fondo transparente (RGBA). Presente solo cuando creaste la tarea conalpha_thumbnail: truey 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: truey la tarea alcanzóSUCCEEDED. Una tarea creada sinmulti_view_thumbnails: trueno 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 guio 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_resolutionen su lugar.
- Name
- geometry_resolution
- Type
- string
- Description
El nivel Ultra en el que se ejecutó la tarea, que es
2k. Una tareastandardno tiene este campo.
- Name
- progress
- Type
- integer
- Description
Cuánto de la tarea está hecho, como porcentaje. Es
0hasta que la tarea comienza y100cuando tiene éxito.
- Name
- started_at
- Type
- timestamp
- Description
Momento en que la tarea comenzó, en milisegundos Unix. Es
0hasta 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
0hasta que la tarea finaliza.
- Name
- status
- Type
- string
- Description
El estado de la tarea, uno de
PENDING,IN_PROGRESS,SUCCEEDED,FAILEDoCANCELED.
- 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. Incluido solo cuando creaste la tarea con todo lo siguiente:
ai_model: meshy-6, con su modelo de textura predeterminadoenable_pbr: true- una
texture_resolutionde2ko4k
- Name
- preceding_tasks
- Type
- integer
- Description
El número de tareas por delante de esta en la cola. El valor solo tiene sentido mientras la tarea está
PENDING.
- Name
- task_error
- Type
- object
- Description
Los detalles del error cuando la tarea falla. Es
nulla menos que el estado seaFAILED. 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_PROGRESSoSUCCEEDED. Es0para una tareaFAILED, porque Meshy reembolsa los créditos cuando una tarea falla.