Creative Lab — API de lámpara

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

Hay dos formas de proporcionar la imagen:

• URL accesible públicamente: Una URL accesible desde internet público.
• Data URI: Una data URI codificada en base64 de la imagen. Ejemplo de una data URI: data:image/jpeg;base64,<your base64-encoded image data>.

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

• character (predeterminado) — sujeto de personaje/objeto único (figura, animal, mascota, etc.).
• landscape — sujeto de escena exterior/panorama (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 fue inaceptable. Causas comunes:

• Parámetro faltante: image_url es obligatorio.
• Formato de imagen invá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 número máximo de píxeles.
• URL inalcanzable: No se pudo descargar el image_url (404 o timeout).
• Data URI inválida: La cadena base64 está mal formada.
• Contenido marcado: La imagen de entrada fue marcada por moderation de NSFW o de propiedad intelectual.
• image_subject inválido: No es uno de character / landscape.

Falló la autenticación. 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 a través de 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 webapp no son aceptadas — el endpoint de build solo acepta 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 de forma uniforme 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 que se corta de forma plana en la base, de modo que la pantalla de la lámpara se apoye en la base de impresión y tenga una abertura para el fixture. Rango: [1, 100].

Preset de fixture de fuente de luz que determina cómo se construye la base. Valores disponibles:

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

Desplazamiento en el eje X del orificio del fixture 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 del fixture 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 el build. 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 fixture), además de 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 bajo model_urls.bundle_zip.

La solicitud no fue aceptable. Causas comunes:

• Falta un parámetro: input_task_id es obligatorio.
• UUID inválido: input_task_id no es un UUID válido.
• El padre no tiene éxito: La tarea de prototipo referenciada aún no ha alcanzado el estado 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 quedó fuera de su rango permitido o de su conjunto de valores enumerados.

Error de autenticación. Comprueba tu clave de API.

Créditos insuficientes para realizar esta tarea.

La tarea de prototipo referenciada no existe, pertenece a otro usuario, o fue creada a través de la webapp (solo las tareas de prototipo en modo API se encadenan con el build).

Has superado tu límite de tasa.

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

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

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

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

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

Puede ser prototype o build. La colección devuelve solo las tareas cuya etapa coincide con la URL — obtener /prototype nunca devuelve tareas de build y viceversa.

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

Límite del tamaño de página. El máximo permitido es 50 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 ordenable por k como detalle de implementación para los id de las tareas, 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 haya finalizado con éxito, esta pasará a 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 se ha iniciado, 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 las tareas FAILED (los créditos se reembolsan en caso de fallo).

URL descargables para el modelo 3D generado a partir de la imagen de concepto. Presente una vez que la tarea haya finalizado con éxito; {} antes de eso.

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

URL descargables para las imágenes de concepto candidatas generadas 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.

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 ha comenzado, esta propiedad será 0. Una vez que la tarea haya finalizado con éxito, 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.

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

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

El número de tareas precedentes. Solo tiene sentido cuando el estado es PENDING.

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