Creative Lab — API de lámpara

Foto de origen que Meshy usa como referencia visual para la pantalla de lámpara. Actualmente admitimos los formatos .jpg, .jpeg, .png y .webp.

Hay dos formas de proporcionar la imagen:

• URL de acceso público: una URL accesible desde internet públicamente.
• Data URI: un URI de datos codificado en base64 de la imagen. Ejemplo de un Data URI: data:image/jpeg;base64,<tus datos de imagen codificados en base64>.

Indicación de categoría de sujeto que selecciona el prompt de estilización. Valores disponibles:

• character (predeterminado) — sujeto de un solo personaje/objeto (figura, animal, mascota, etc.).
• landscape — escena exterior/panorama como sujeto (montaña, paisaje urbano, bosque, etc.).

Nombre de tarea opcional para fines de visualización. Máximo 100 caracteres.

Cuando se establece en true, la imagen de prototipo se devuelve como un PNG RGBA transparente con el fondo eliminado, para que puedas componer el sujeto sobre cualquier fondo.

La solicitud no fue aceptable. Causas comunes:

• Parámetro faltante: image_url es obligatorio.
• Formato de imagen no válido: el image_url proporcionado no tiene un formato compatible (.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 recuento máximo de píxeles.
• URL inaccesible: no se pudo descargar el image_url (404 o timeout).
• Data URI no válido: la cadena en base64 está mal formada.
• Contenido marcado: la imagen de entrada fue marcada por moderation de contenido NSFW o de propiedad intelectual.
• image_subject no válido: no es uno de character / landscape.

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

Créditos insuficientes para realizar esta tarea.

Has excedido tu límite de tasa.

El ID de tarea de una tarea de prototipo creada mediante este mismo endpoint de OpenAPI. El prototipo debe haberse creado con la misma clave de API, debe haber alcanzado SUCCEEDED, y debe haber producido un modelo 3D.

Las tareas de prototipo creadas a través de la aplicación web no son aceptadas — el endpoint de construcción acepta únicamente tareas de prototipo producidas por POST /openapi/creative-lab/lamp/v1/prototype y rechaza cualquier otro origen con 404.

Nombre de tarea opcional para fines de visualización. Máximo 100 caracteres.

Dimensión máxima objetivo de la caja delimitadora de la pantalla de la lámpara, en milímetros. La malla se escala uniformemente para ajustarse. Rango: [50, 400].

Grosor de pared de la pantalla de lámpara hueca, en milímetros. Rango: (0, 10].

Porcentaje de la altura del modelo cortado de forma plana en la parte inferior, de modo que la pantalla de la lámpara se asiente en la cama de impresión y tenga una abertura para la fijación. Rango: [1, 100].

Preset de fijación de fuente de luz que determina cómo se construye la parte inferior. Valores disponibles:

• bambu_mh001_60mm (predeterminado) — pantalla de lámpara con base abierta más una placa base con un orificio de fijación de 60 mm, ambos en model_urls.lamp_stl, y el soporte de fijación como model_urls.base_stl.
• none — una única pantalla de lámpara sellada en model_urls.lamp_stl; se omite model_urls.base_stl.

Desplazamiento en el eje X del orificio de fijación en la placa base, relativo al centro de la pantalla de la lámpara, en milímetros. Solo tiene sentido cuando light_source_preset ≠ none. Rango: [-80, 80].

Desplazamiento en el eje Z (profundidad) del orificio de fijación en la placa base, relativo al centro de la pantalla de la lámpara, en milímetros. Solo tiene sentido cuando light_source_preset ≠ none. Rango: [-80, 80].

Rotación alrededor del eje X aplicada al modelo antes del procesamiento, en grados. Las tres rotaciones se aplican como ángulos de Euler XYZ alrededor del centro del modelo. Rango: [-360, 360].

Rotación alrededor del eje Y aplicada a la malla importada antes del procesamiento, en grados. Rango: [-360, 360].

Rotación alrededor del eje Z aplicada a la malla importada antes del procesamiento, en grados. Rango: [-360, 360].

Cuando es true y output.format es zip, incluye el result.json del procesador de lámparas (nombre del pipeline, advertencias y rutas de artefactos) dentro del paquete. Se ignora cuando output.format es stl.

Paquete de artefactos devuelto por la construcción. Valores disponibles:

• stl (predeterminado) — devuelve model_urls.lamp_stl (la pantalla de la lámpara, junto con la placa base cuando se establece un preset de fijación), más model_urls.base_stl cuando light_source_preset ≠ none.
• zip — empaqueta todos los artefactos que emite el procesador (lamp.stl, base.stl opcional, result.json opcional) en un único zip y lo devuelve en model_urls.bundle_zip.

La solicitud fue inaceptable. Causas comunes:

• Parámetro faltante: input_task_id es obligatorio.
• UUID inválido: El input_task_id no es un UUID válido.
• Padre no exitoso: La tarea de prototipo referenciada aún no ha alcanzado SUCCEEDED.
• Sin modelo: La tarea de prototipo tuvo éxito pero no produjo ningún modelo 3D.
• Opciones fuera de rango: Uno de los campos de options estaba fuera de su rango permitido o conjunto de valores enumerados.

Falló la autenticación. Por favor, verifica tu clave de API.

Créditos insuficientes para realizar esta tarea.

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 pueden encadenarse a una construcción).

Has excedido tu límite de tasa.

Identificador único de la tarea de lámpara que se desea recuperar.

Identificador único de la tarea de lámpara que se va a cancelar.

La tarea ya está en un estado terminal y no se puede cancelar.

La tarea no existe, pertenece a un usuario diferente o su etapa no coincide con la ruta de la URL.

Identificador único de la tarea de lámpara a transmitir.

Ya sea prototype o build. La colección devuelve únicamente las tareas cuya etapa coincida con la URL — obtener /prototype nunca devuelve tareas de construcción y viceversa.

Número de página para la paginación.

Límite de tamaño de página. El máximo permitido es 100 elementos.

Campo por el cual ordenar. Valores disponibles:

• +created_at: Ordenar por hora de creación en orden ascendente.
• -created_at: Ordenar por hora de creación en orden descendente.

Identificador único de la tarea. Aunque usamos un UUID k-ordenable para los ids de tareas como detalle de implementación, no debes hacer ninguna suposición sobre el formato del id.

Tipo de la tarea. El valor es creative-lab-lamp-prototype.

El nombre de la tarea proporcionado al crearla. Cadena vacía si no se proporcionó ningún nombre.

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

Progreso de la tarea. Si la tarea aún no ha comenzado, esta propiedad será 0. Una vez que la tarea se haya completado con éxito, esta será 100.

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

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

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

Marca de tiempo de cuándo expira el resultado de la tarea, en milisegundos.

El recuento de tareas precedentes.

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

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

URLs descargables para el modelo 3D generado a partir de la imagen conceptual. Presente una vez que la tarea se haya completado con éxito; {} antes de eso.

URL descargable a una vista previa renderizada del modelo 3D. Cadena vacía hasta que la tarea se haya completado con éxito.

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 arreglo para que futuras revisiones puedan mostrar múltiples candidatos sin un cambio disruptivo.

Identificador único de la tarea.

Tipo de la tarea. El valor es creative-lab-lamp-build.

El nombre de la tarea proporcionado al crearla. Cadena vacía si no se proporcionó ningún nombre.

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

Progress 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, pasará a ser 100.

Marca de tiempo de cuando se creó la tarea, en milisegundos.

Marca de tiempo de cuando se inició la tarea, en milisegundos.

Marca de tiempo de cuando finalizó la tarea, en milisegundos.

Marca de tiempo de cuando expira el resultado de la tarea, en milisegundos.

El recuento de tareas precedentes. Solo tiene sentido cuando el estado es PENDING.

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

El número de créditos consumidos por esta tarea. Devuelve 0 para tareas FAILED (los créditos se reembolsan en caso de fallo).

URLs descargables para los artefactos generados, indexadas por nombre de artefacto. El conjunto de claves depende de output.format y options.light_source_preset: