Creative Lab — API de Imán de Nevera

Convierte tus fotos en imanes de nevera personalizados — un relieve de profundidad colorizado en forma de rectángulo redondeado con un respaldo magnético plano, del tamaño adecuado para la nevera — en dos etapas: prototipo genera una imagen conceptual colorizada a partir de tu foto de entrada, luego construcción convierte esa imagen conceptual en un modelo 3D en relieve. Las dos etapas están vinculadas a través de input_task_id.

POST /openapi/creative-lab/fridge-magnet/v1/prototype
POST /openapi/creative-lab/fridge-magnet/v1/build

POST/openapi/creative-lab/fridge-magnet/v1/prototype

Crear una Tarea de Prototipo de Imán de Nevera

Genera una imagen conceptual colorizada a partir de la foto de origen. El ID de tarea devuelto es lo que pasas como input_task_id al endpoint de construcción. Consulta El Objeto de Tarea de Prototipo de Imán de Nevera para la estructura de la respuesta.

Parámetros

Name
image_url
Type
string
Requerido
Description
Foto de origen para que Meshy la colorice en una imagen conceptual lista para imán de nevera. Actualmente soportamos los formatos .jpg, .jpeg, .png y .webp.
Hay dos maneras de proporcionar la imagen:
- URL públicamente accesible: Una URL que es accesible desde internet público.
- Data URI: Un Data URI codificado en base64 de la imagen. Ejemplo de un Data URI: data:image/jpeg;base64,<your base64-encoded image data>.
Name
name
Type
string
Description
Nombre de tarea opcional para propósitos de visualización. Máximo 100 caracteres.
Name
remove_background
Type
boolean
predeterminado false
Description
Cuando se establece en true, la imagen prototipo se devuelve como un PNG RGBA transparente con el fondo eliminado, para que puedas componer el sujeto en cualquier fondo.
Esto controla solo la imagen que este endpoint devuelve. Es independiente de la opción de construcción del mismo nombre (por defecto true), que controla la eliminación del fondo antes del relieve.

Retornos

La propiedad result de la respuesta contiene el id de la tarea recién creada de prototipo de imán de nevera. Consulta el endpoint Obtener una Tarea o suscríbete al stream hasta que la tarea alcance SUCCEEDED, luego pasa ese ID al endpoint de construcción como input_task_id.

Modos de Fallo

Name
400 - Bad Request
Description
La solicitud fue inaceptable. Causas comunes:
- Parámetro faltante: image_url es requerido.
- Formato de imagen inválido: El image_url proporcionado no es un formato soportado (.jpg, .jpeg, .png, .webp).
- Dimensiones de imagen fuera de rango: La imagen es demasiado pequeña, excede el tamaño máximo de archivo, o excede el conteo máximo de píxeles.
- URL inalcanzable: No se pudo descargar el image_url (404 o timeout).
- Data URI inválido: La cadena base64 está mal formada.
- Contenido marcado: La imagen de entrada fue marcada por moderation de NSFW o propiedad intelectual.
Name
401 - Unauthorized
Description
La autenticación falló. Por favor, 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/creative-lab/fridge-magnet/v1/prototype

# Stage 1: generate a colorized fridge magnet concept image
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_url": "<your publicly accessible image url or base64-encoded data URI>"
  }'

Response

{
  "result": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9"
}

Ejemplo de prototipo

Comienza con una foto de origen, luego genera la imagen prototipo utilizada por la etapa de construcción del imán de nevera.

Foto de paisaje de origen utilizada como entrada del Imán de Nevera del Creative Lab — Entrada del prototipo

Salida del prototipo del Imán de Nevera del Creative Lab generada a partir de la foto de origen — Salida del prototipo

POST/openapi/creative-lab/fridge-magnet/v1/build

Crear una Tarea de Construcción de Imán de Nevera

Genera el imán de nevera final imprimible en 3D a partir de una tarea de prototipo exitosa. La construcción ejecuta una canalización de relieve de mapa de profundidad en la imagen conceptual coloreada del prototipo y envía un único artefacto de malla en el formato que solicites. Consulta El Objeto de Tarea de Construcción de Imán de Nevera para la forma de la respuesta.

Parámetros

Name
input_task_id
Type
string
Requerido
Description
El ID de la tarea de un prototipo creado a través de este mismo endpoint de OpenAPI. El prototipo debe haber sido creado con la misma clave de API, debe haber alcanzado SUCCEEDED y debe haber producido exactamente una imagen candidata.
Las tareas de prototipo creadas a través de la aplicación web no son aceptadas — el endpoint de construcción solo acepta tareas de prototipo producidas por POST /openapi/creative-lab/fridge-magnet/v1/prototype y rechaza cualquier otra fuente con 404.
Name
name
Type
string
Description
Nombre de tarea opcional para propósitos de visualización. Máximo 100 caracteres.

`options`

Parámetros de ajuste opcionales para la geometría de relieve. Cada campo tiene un valor predeterminado razonable — envía solo aquellos que desees sobrescribir.

Name
badge_shape
Type
string
predeterminado rounded-rect
Description
Silueta del contorno del imán de nevera. Valores disponibles:
- circle
- rounded-rect (predeterminado)
- hexagon
- shield
- star
Name
size_mm
Type
number
predeterminado 60
Description
Longitud del borde del cuadrado delimitador del imán de nevera, en milímetros. Rango: (0, 400].
Name
relief_height_mm
Type
number
predeterminado 3.3
Description
Altura máxima del relieve sobre la base, en milímetros. Rango: [0, 20].
Name
relief_offset_mm
Type
number
predeterminado 0
Description
Desplazamiento vertical aplicado al relieve antes de la extrusión, en milímetros. Rango: [0, 20].
Name
base_thickness_mm
Type
number
predeterminado 2.0
Description
Grosor de la placa base plana detrás del relieve, en milímetros. El predeterminado para el imán de nevera es una base más gruesa de 2 mm — da al imán suficiente cuerpo para adherirse a la nevera sin que el relieve se sienta frágil. Rango: [0, 20].
Name
has_closed_back
Type
boolean
predeterminado true
Description
Si la parte trasera del imán de nevera está sellada como una superficie cerrada (el lado al que se pega el imán). Establecer en false para una carcasa abierta.
Name
relief_curve
Type
string
predeterminado linear
Description
Curva de transferencia que mapea los valores del mapa de profundidad a la altura del relieve. Valores disponibles:
- linear (predeterminado)
- gamma
- s-curve
Name
curve_param
Type
number
predeterminado 1.0
Description
Parámetro de forma para la curva de transferencia (solo significativo cuando relief_curve es gamma). Rango: (0, 10].
Name
invert_depth
Type
boolean
predeterminado false
Description
Invierte la interpretación del mapa de profundidad para que las regiones más oscuras se conviertan en un relieve más alto.
Name
smoothing
Type
number
predeterminado 0.24
Description
Fuerza de suavizado aplicada al mapa de profundidad antes de la extracción del relieve. Rango: [0, 10].
Name
relief_scale
Type
number
predeterminado 1.0
Description
Multiplicador de escala vertical aplicado sobre relief_height_mm. Rango: (0, 10].
Name
depth_threshold
Type
number
predeterminado 0.1
Description
Umbral de paso bajo para los valores del mapa de profundidad; cualquier valor por debajo de esto se ajusta a cero. Rango: [0, 1].
Name
remove_background
Type
boolean
predeterminado true
Description
Elimina automáticamente el fondo de la imagen conceptual del prototipo antes de aplicar el relieve.
Separado del parámetro de prototipo del mismo nombre (predeterminado false), que controla si la imagen del prototipo en sí se devuelve con transparencia.
Name
export_resolution
Type
integer
predeterminado 512
Description
Resolución de malla utilizada para la exportación. Rango: [64, 2048].

`output`

Selector de formato de cable opcional. Por defecto es glb.

Name
format
Type
string
predeterminado glb
Description
Paquete de artefactos devuelto por la construcción. Valores disponibles:
- glb (predeterminado) — devuelve un único model.glb bajo model_urls.glb.
- obj — comprime model.obj + model.mtl + texture.png y devuelve el paquete bajo model_urls.obj.
- zip — comprime cada artefacto que el generador emite y devuelve el paquete bajo model_urls.bundle_zip.

Retornos

La propiedad result de la respuesta contiene el id de la tarea de construcción de imán de nevera recién creada. Consulta el endpoint Obtener una Tarea o suscríbete al stream hasta que la tarea alcance SUCCEEDED, luego descarga el artefacto de la única entrada en model_urls.

Modos de Fallo

Name
400 - Bad Request
Description
La solicitud no fue aceptable. Causas comunes:
- Parámetro faltante: input_task_id es requerido.
- UUID inválido: El input_task_id no es un UUID válido.
- Padre no exitoso: La tarea de prototipo referenciada no ha alcanzado SUCCEEDED aún.
- Sin candidato: La tarea de prototipo tuvo éxito pero no produjo ninguna imagen candidata.
- Opciones fuera de rango: Uno de los campos de options cayó fuera de su rango permitido o conjunto de enumeración.
Name
401 - Unauthorized
Description
La autenticación falló. Por favor, verifica tu clave de API.
Name
402 - Payment Required
Description
Créditos insuficientes para realizar esta tarea.
Name
404 - Not Found
Description
La tarea de prototipo referenciada no existe, pertenece a un usuario diferente, o fue creada a través de la aplicación web (solo las tareas de prototipo en modo API se encadenan en la construcción).
Name
429 - Too Many Requests
Description
Has excedido tu límite de tasa.

Request

POST

/openapi/creative-lab/fridge-magnet/v1/build

# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "options": {
      "badge_shape": "rounded-rect",
      "size_mm": 60,
      "relief_height_mm": 3.3
    },
    "output": {
      "format": "glb"
    }
  }'

Response

{
  "result": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0"
}

Ejemplo de construcción

La tarea de construcción convierte la imagen de prototipo seleccionada en un modelo de imán de nevera imprimible en 3D.

Vista previa del modelo de construcción de Imán de Nevera del Creative Lab — Vista previa del modelo de construcción

GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id

Recuperar una Tarea de Imán de Nevera

Recupera una tarea de prototipo o construcción dada una id de tarea válida. La ruta de URL debe coincidir con la etapa de la tarea: una tarea de construcción obtenida a través de /prototype/:id devuelve 404, y viceversa.

Consulta El Objeto de Tarea de Prototipo de Imán de Nevera y El Objeto de Tarea de Construcción de Imán de Nevera para las formas de respuesta.

Parámetros

Name
id
Type
path
Description
Identificador único para la tarea de imán de nevera a recuperar.

Devuelve

La respuesta contiene el objeto de tarea de imán de nevera. La forma depende de cuál etapa fue solicitada.

Solicitud

GET

/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9

# Prototype
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Respuesta de Prototipo

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Respuesta de Construcción

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}

DELETE/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id

Eliminar una Tarea de Imán de Nevera

Cancela una tarea de imán de nevera. Si la tarea aún está PENDING, los créditos consumidos en el momento de la creación son reembolsados. Las tareas que ya están IN_PROGRESS se cancelan sin reembolso (el trabajador puede ya estar consumiendo recursos). Las tareas que ya han alcanzado un estado terminal (SUCCEEDED, FAILED, CANCELED) no pueden ser canceladas.

La ruta de la URL debe coincidir con la etapa de la tarea — DELETE en /prototype/:buildId devuelve 404.

Parámetros de Ruta

Name
id
Type
path
Description
Identificador único para la tarea de imán de nevera a cancelar.

Retornos

Devuelve 204 No Content en caso de éxito con un cuerpo vacío.

Modos de Fallo

Name
400 - Bad Request
Description
La tarea ya está en un estado terminal y no puede ser cancelada.
Name
404 - Not Found
Description
La tarea no existe, pertenece a un usuario diferente, o su etapa no coincide con la ruta de la URL.

Request

DELETE

/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9

curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype/01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 204 No Content on success (empty body).

GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)/:id/stream

Transmitir una Tarea de Imán de Nevera

Transmite actualizaciones en tiempo real para una tarea de imán de nevera a través de Server-Sent Events (SSE). La ruta de la URL debe coincidir con la etapa de la tarea: abrir una transmisión en /prototype/:buildId/stream emite un único event: error payload con status_code: 404 y cierra la transmisión.

Parámetros

Name
id
Type
path
Description
Identificador único para la tarea de imán de nevera a transmitir.

Devuelve

Devuelve una transmisión de objetos de tarea Prototipo de Imán de Nevera o Construcción de Imán de Nevera como Server-Sent Events. Para tareas PENDING o IN_PROGRESS, la transmisión de respuesta solo incluirá los campos necesarios progress y status.

Solicitud

GET

/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/stream

curl -N https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Transmisión de Respuesta

// Error event example (wrong stage or task not found)
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": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}

GET/openapi/creative-lab/fridge-magnet/v1/(prototype|build)

Listar Tareas de Imán de Nevera

Recupera una lista paginada de tus tareas de imán de nevera para una sola etapa. La ruta URL selecciona la etapa — /prototype devuelve tareas de prototipo; /build devuelve tareas de construcción. Las tareas de la otra etapa no se incluyen en ninguna respuesta.

Parámetros de Ruta

Name
stage
Type
path
Requerido
Description
Ya sea prototype o build. La colección devuelve solo tareas cuya etapa coincide con la URL — obtener /prototype nunca devuelve tareas de construcción y viceversa.

Parámetros de Consulta

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

Devuelve

Devuelve una lista paginada del objeto de tarea por etapa — ya sea el objeto de tarea de prototipo de imán de nevera al listar /prototype o el objeto de tarea de construcción de imán de nevera al listar /build.

Request

GET

/openapi/creative-lab/fridge-magnet/v1/prototype

# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/fridge-magnet/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response (List Prototype Tasks)

[
  {
    "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
    "type": "creative-lab-fridge-magnet-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729543210000,
    "started_at": 1729543215000,
    "finished_at": 1729543242000,
    "expires_at": 1729802442000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

El Objeto de Tarea del Prototipo de Imán de Nevera

El objeto de tarea del prototipo de imán de nevera es una unidad de trabajo que Meshy sigue para generar una imagen conceptual colorizada a partir de una foto de origen. La salida de esta etapa se encadena en la etapa de construcción a través de input_task_id.

Propiedades

Name
id
Type
string
Description
Identificador único para la tarea. Aunque usamos un UUID ordenable por k 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. El valor es creative-lab-fridge-magnet-prototype.
Name
name
Type
string
Description
El nombre de la tarea proporcionado cuando se creó la tarea. Cadena vacía si no se proporcionó ningún nombre.
Name
status
Type
string
Description
Estado de la tarea. Los valores posibles son uno de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
progress
Type
integer
Description
Progreso de la tarea. Si la tarea aún no ha comenzado, esta propiedad será 0. Una vez que la tarea haya tenido éxito, esto se convertirá en 100.
Name
created_at
Type
timestamp
Description
Marca de tiempo de cuando se creó la tarea, en milisegundos.
Una marca de tiempo representa el número 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 se aplica a todas las marcas de tiempo en Meshy API.
Name
started_at
Type
timestamp
Description
Marca de tiempo de cuando se inició la tarea, en milisegundos. Si la tarea aún no ha comenzado, esta propiedad será 0.
Name
finished_at
Type
timestamp
Description
Marca de tiempo de cuando se terminó la tarea, en milisegundos. Si la tarea aún no ha terminado, esta propiedad será 0.
Name
expires_at
Type
timestamp
Description
Marca de tiempo de cuando expira el resultado de la tarea, en milisegundos.
Name
preceding_tasks
Type
integer
Description
El conteo de tareas precedentes.
El valor de este campo es significativo solo 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).
Name
image_urls
Type
array of strings
Description
URLs descargables para los candidatos de imagen conceptual generados por esta tarea de prototipo. Actualmente, la API siempre devuelve exactamente un candidato; el campo es un array para que futuras revisiones puedan mostrar múltiples candidatos sin un cambio disruptivo.

Ejemplo de Objeto de Tarea del Prototipo de Imán de Nevera

{
  "id": "01a3d8f1-8c2e-7d04-b223-3f3776a1c8c9",
  "type": "creative-lab-fridge-magnet-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543210000,
  "started_at": 1729543215000,
  "finished_at": 1729543242000,
  "expires_at": 1729802442000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

El Objeto de Tarea de Construcción de Imán de Nevera

El objeto de Tarea de Construcción de Imán de Nevera es una unidad de trabajo que Meshy rastrea para generar la malla final del imán de nevera 3D a partir de una tarea de prototipo exitosa. La construcción ejecuta una canalización de relieve de mapa de profundidad en la imagen conceptual del prototipo y publica un único artefacto de malla en el formato solicitado por el llamante.

Propiedades

Name
id
Type
string
Description
Identificador único para la tarea.
Name
type
Type
string
Description
Tipo de la tarea. El valor es creative-lab-fridge-magnet-build.
Name
name
Type
string
Description
El nombre de la tarea proporcionado cuando se creó la tarea. Cadena vacía si no se proporcionó un nombre.
Name
status
Type
string
Description
Estado de la tarea. Los valores posibles son uno de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
progress
Type
integer
Description
Progreso de la tarea. Si la tarea aún no ha comenzado, esta propiedad será 0. Una vez que la tarea haya tenido éxito, esto se convertirá en 100.
Name
created_at
Type
timestamp
Description
Marca de tiempo de cuando se creó la tarea, en milisegundos.
Name
started_at
Type
timestamp
Description
Marca de tiempo de cuando se inició la tarea, en milisegundos.
Name
finished_at
Type
timestamp
Description
Marca de tiempo de cuando se terminó la tarea, en milisegundos.
Name
expires_at
Type
timestamp
Description
Marca de tiempo de cuando expira el resultado de la tarea, en milisegundos.
Name
preceding_tasks
Type
integer
Description
El conteo de tareas precedentes. Significativo solo cuando el estado es PENDING.
Name
task_error
Type
object
Description
Detalles del error para tareas fallidas. Consulte 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. Devuelve 0 para tareas FAILED (los créditos se reembolsan en caso de fallo).
Name
model_urls
Type
object
Description
URLs descargables para el artefacto generado, indexados por el nombre del artefacto. Siempre contiene exactamente una entrada: el formato solicitado a través de la solicitud de construcción output.format. La clave coincide con el formato solicitado:
- Name
  glb
  Type
  string
  Description
  URL descargable para el archivo GLB. Presente cuando output.format era glb (el predeterminado).
- Name
  obj
  Type
  string
  Description
  URL descargable para un paquete zip que contiene model.obj, model.mtl y texture.png. Presente cuando output.format era obj.
- Name
  bundle_zip
  Type
  string
  Description
  URL descargable para un paquete zip de cada artefacto que el generador emite. Presente cuando output.format era zip.

Ejemplo de Objeto de Tarea de Construcción de Imán de Nevera

{
  "id": "01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0",
  "type": "creative-lab-fridge-magnet-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729543250000,
  "started_at": 1729543258000,
  "finished_at": 1729543285000,
  "expires_at": 1729802485000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 20,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/01b4e9a2-9d3f-8e15-c334-4f4887b2d9d0/output/model.glb?Expires=***"
  }
}