Creative Lab — API lampada

Foto sorgente che Meshy utilizza come riferimento visivo per il paralume. Attualmente supportiamo i formati .jpg, .jpeg, .png e .webp.

Ci sono due modi per fornire l'immagine:

• URL accessibile pubblicamente: Un URL accessibile da internet pubblicamente.
• Data URI: Un data URI dell'immagine codificato in base64. Esempio di Data URI: data:image/jpeg;base64,<i tuoi dati immagine codificati in base64>.

Suggerimento sulla categoria del soggetto che seleziona il prompt di stylization. Valori disponibili:

• character (predefinito) — soggetto singolo personaggio/oggetto (statuina, animale, mascotte, ecc.).
• landscape — soggetto scena esterna/panoramica (montagna, paesaggio urbano, foresta, ecc.).

Nome del task opzionale per scopi di visualizzazione. Massimo 100 caratteri.

Quando impostato su true, l'immagine del prototipo viene restituita come PNG RGBA trasparente con lo sfondo rimosso, in modo da poter comporre il soggetto su qualsiasi sfondo.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: image_url è obbligatorio.
• Formato immagine non valido: L'image_url fornito non è in un formato supportato (.jpg, .jpeg, .png, .webp).
• Dimensioni immagine fuori intervallo: L'immagine è troppo piccola, supera la dimensione massima del file o supera il numero massimo di pixel.
• URL non raggiungibile: L'image_url non è stato possibile scaricarlo (404 o timeout).
• Data URI non valido: La stringa base64 è malformata.
• Contenuto segnalato: L'immagine di input è stata segnalata dalla moderation NSFW o per proprietà intellettuale.
• image_subject non valido: Non è uno tra character / landscape.

Autenticazione fallita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questo task.

Hai superato il tuo limite di frequenza.

L'ID dell'attività di un'attività di prototipo creata tramite questo stesso endpoint OpenAPI. Il prototipo deve essere stato creato con la stessa chiave API, deve aver raggiunto SUCCEEDED e deve aver prodotto un modello 3D.

Le attività di prototipo create tramite la webapp non sono accettate — l'endpoint di build accetta solo attività di prototipo prodotte da POST /openapi/creative-lab/lamp/v1/prototype e rifiuta qualsiasi altra origine con 404.

Nome dell'attività opzionale a scopo di visualizzazione. Massimo 100 caratteri.

Dimensione massima target del bounding box del paralume, in millimetri. La mesh viene ridimensionata uniformemente per adattarsi. Intervallo: [50, 400].

Spessore parete del paralume cavo, in millimetri. Intervallo: (0, 10].

Percentuale dell'altezza del modello tagliata in piano sul fondo, in modo che il paralume poggi sul piano di stampa e abbia un'apertura per il supporto. Intervallo: [1, 100].

Preset del supporto della sorgente luminosa che determina come viene costruito il fondo. Valori disponibili:

• bambu_mh001_60mm (predefinito) — paralume con fondo aperto più una piastra di base con un foro per supporto da 60 mm, entrambi in model_urls.lamp_stl, e il montaggio del supporto come model_urls.base_stl.
• none — un unico paralume sigillato in model_urls.lamp_stl; model_urls.base_stl viene omesso.

Offset sull'asse X del foro del supporto sulla piastra di base, rispetto al centro del paralume, in millimetri. Significativo solo quando light_source_preset ≠ none. Intervallo: [-80, 80].

Offset sull'asse Z (profondità) del foro del supporto sulla piastra di base, rispetto al centro del paralume, in millimetri. Significativo solo quando light_source_preset ≠ none. Intervallo: [-80, 80].

Rotazione attorno all'asse X applicata al modello prima dell'elaborazione, in gradi. Le tre rotazioni sono applicate come angoli di Eulero XYZ attorno al centro del modello. Intervallo: [-360, 360].

Rotazione attorno all'asse Y applicata alla mesh importata prima dell'elaborazione, in gradi. Intervallo: [-360, 360].

Rotazione attorno all'asse Z applicata alla mesh importata prima dell'elaborazione, in gradi. Intervallo: [-360, 360].

Quando è true e output.format è zip, include il result.json del processore lamp (nome della pipeline, avvisi e percorsi degli artefatti) all'interno del pacchetto. Ignorato quando output.format è stl.

Pacchetto di artefatti restituito dal build. Valori disponibili:

• stl (predefinito) — restituisce model_urls.lamp_stl (il paralume, insieme alla piastra di base quando è impostato un preset di supporto), più model_urls.base_stl quando light_source_preset ≠ none.
• zip — raggruppa ogni artefatto emesso dal processore (lamp.stl, base.stl opzionale, result.json opzionale) in un unico zip e lo restituisce sotto model_urls.bundle_zip.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: input_task_id è obbligatorio.
• UUID non valido: input_task_id non è un UUID valido.
• Parent non completato: L'attività di prototipo referenziata non ha ancora raggiunto SUCCEEDED.
• Nessun modello: L'attività di prototipo è stata completata con successo ma non ha prodotto alcun modello 3D.
• Opzioni fuori intervallo: Uno dei campi di options era al di fuori dell'intervallo consentito o dell'insieme di valori enum.

Autenticazione fallita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività.

L'attività di prototipo referenziata non esiste, appartiene a un utente diverso, oppure è stata creata tramite la webapp (solo le attività di prototipo in modalità API si concatenano al build).

Hai superato il tuo limite di frequenza.

Identificatore univoco del task lampada da recuperare.

Identificatore univoco dell'attività lampada da annullare.

L'attività si trova già in uno stato terminale e non può essere annullata.

L'attività non esiste, appartiene a un utente diverso, oppure la sua fase non corrisponde al percorso URL.

Identificatore univoco dell'attività lampada di cui eseguire lo streaming.

prototype o build. La raccolta restituisce solo le attività la cui fase corrisponde all'URL — richiedere /prototype non restituisce mai attività di build e viceversa.

Numero di pagina per la paginazione.

Limite di dimensione della pagina. Il massimo consentito è 100 elementi.

Campo per l'ordinamento. Valori disponibili:

• +created_at: Ordina per data di creazione in ordine crescente.
• -created_at: Ordina per data di creazione in ordine decrescente.

Identificatore univoco del task. Sebbene per gli id dei task utilizziamo un UUID ordinabile per k come dettaglio implementativo, non dovresti fare alcuna assunzione sul formato dell'id.

Tipo del task. Il valore è creative-lab-lamp-prototype.

Il nome del task fornito al momento della creazione. Stringa vuota se non è stato fornito alcun nome.

Stato del task. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Avanzamento del task. Se il task non è ancora iniziato, questa proprietà sarà 0. Una volta che il task è riuscito, diventerà 100.

Timestamp di quando il task è stato creato, in millisecondi.

Timestamp di quando il task è stato avviato, in millisecondi. Se il task non è ancora iniziato, questa proprietà sarà 0.

Timestamp di quando il task è stato completato, in millisecondi. Se il task non è ancora terminato, questa proprietà sarà 0.

Timestamp di quando il risultato del task scade, in millisecondi.

Il conteggio dei task precedenti.

Dettagli dell'errore per i task falliti. Consulta Errori per il riferimento completo dell'oggetto task_error.

Il numero di crediti consumati da questo task. Presente quando lo stato del task è PENDING, IN_PROGRESS o SUCCEEDED. Restituisce 0 per i task FAILED (i crediti vengono rimborsati in caso di fallimento).

URL scaricabili per il modello 3D generato dall'immagine concettuale. Presente una volta che il task è riuscito; {} prima di ciò.

URL scaricabile di un'anteprima renderizzata del modello 3D. Stringa vuota finché il task non è riuscito.

URL scaricabili per i candidati dell'immagine concettuale generati da questo task di prototipazione. Attualmente l'API restituisce sempre esattamente un candidato; il campo è un array in modo che revisioni future possano esporre più candidati senza introdurre una modifica non retrocompatibile.

Identificatore univoco del task.

Tipo del task. Il valore è creative-lab-lamp-build.

Il nome del task fornito al momento della creazione del task. Stringa vuota se non è stato fornito alcun nome.

Stato del task. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Progresso del task. Se il task non è ancora iniziato, questa proprietà sarà 0. Una volta che il task è riuscito, diventerà 100.

Timestamp di quando il task è stato creato, in millisecondi.

Timestamp di quando il task è stato avviato, in millisecondi.

Timestamp di quando il task è stato completato, in millisecondi.

Timestamp di quando il risultato del task scade, in millisecondi.

Il numero di task precedenti. Significativo solo quando lo stato è PENDING.

Dettagli dell'errore per i task non riusciti. Consulta Errori per il riferimento completo dell'oggetto task_error.

Il numero di crediti consumati da questo task. Restituisce 0 per i task FAILED (i crediti vengono rimborsati in caso di fallimento).

URL scaricabili per gli artefatti generati, indicizzati per nome dell'artefatto. L'insieme delle chiavi dipende da output.format e options.light_source_preset: