Creative Lab Lamp API

La foto su cui basare il paralume, come URL pubblico o data URI (data:image/jpeg;base64,<your base64-encoded image data>).

L'immagine deve essere un file JPG, JPEG, PNG o WebP di al massimo 20 MB.

Il tipo di soggetto nella foto, che determina come Meshy lo stilizza.

Valori disponibili:

• character: un singolo personaggio o oggetto, come una statuina, un animale o una mascotte
• landscape: una scena all'aperto o un panorama, come una montagna, un paesaggio urbano o una foresta

Un nome per l'attività, fino a 100 caratteri. Viene restituito nel campo name dell'attività. Un nome più lungo restituisce 400.

Se rimuovere lo sfondo dall'immagine del prototipo. true restituisce un PNG RGBA trasparente, così puoi collocare il soggetto su qualsiasi sfondo. Meshy costruisce inoltre il modello 3D dall'immagine senza il suo sfondo. Se Meshy non riesce a rimuovere lo sfondo, utilizza l'immagine con il suo sfondo, e l'attività comunque riesce.

La richiesta non può essere eseguita. Ad esempio:

• image_url è mancante.
• L'immagine non è un file JPG, JPEG, PNG o WebP.
• L'immagine è troppo piccola, supera i 20 MB o il numero massimo di pixel.
• Meshy non riesce a scaricare l'immagine, ad esempio perché l'URL restituisce 404 o va in timeout.
• Il data URI non è una base64 valida.
• L'immagine è stata segnalata come NSFW.
• image_subject non è character né landscape.

Il messaggio di errore indica quale problema ha riscontrato. Correggi la richiesta, poi inviala di nuovo.

La chiave API è mancante o non valida. Controlla l'intestazione Authorization.

Si applica una di queste condizioni:

• L'account non ha crediti sufficienti.
• La chiave API, lo spazio di lavoro o il membro ha raggiunto il proprio limite di crediti.
• L'account è sul piano gratuito.

Controlla i tuoi crediti e il tuo piano, poi riprova.

Il tuo team ha attivato IP Filtering, e Meshy ha segnalato l'immagine per proprietà intellettuale di terzi. Invia un'immagine che hai il diritto di utilizzare.

È stato raggiunto uno di questi limiti:

• Hai inviato più richieste di quelle consentite dal tuo limite di frequenza. Attendi qualche secondo, poi riprova. Vedi Limiti di frequenza.
• Troppe delle tue attività sono in coda o in esecuzione. Attendi che alcune finiscano, poi riprova.
• Su un piano illimitato senza crediti residui, hai raggiunto il numero di attività che possono essere eseguite senza crediti. Attendi che un'attività finisca, oppure aggiungi crediti.

Meshy ha riscontrato un errore del server, ad esempio perché non è riuscito a eseguire il controllo sulla proprietà intellettuale sull'immagine. Meshy non crea l'attività e rimborsa eventuali crediti addebitati. Riprova la richiesta.

L'ID dell'attività di prototipo da compilare. Deve essere un'attività creata dal tuo account con POST /openapi/creative-lab/lamp/v1/prototype, con stato SUCCEEDED.

Un ID che non corrisponde a una delle tue attività di prototipo Lamp create tramite l'API restituisce 404, incluso un prototipo creato nell'app web.

Un nome per l'attività, fino a 100 caratteri. Viene restituito nel campo name dell'attività. Un nome più lungo restituisce 400.

La dimensione massima del paralume, in millimetri, da 50 a 400. Meshy ridimensiona uniformemente il modello per adattarlo. 0 usa il valore predefinito e qualsiasi altro valore fuori intervallo restituisce 400.

Lo spessore parete del paralume, in millimetri, fino a 10. 0 usa il valore predefinito, mentre un valore negativo o superiore a 10 restituisce 400.

La percentuale dell'altezza del modello da tagliare in piano nella parte inferiore, da 1 a 100. Il fondo piatto permette al paralume di appoggiarsi sul piano di stampa e lascia spazio per il fissaggio. Un valore fuori intervallo restituisce 400.

Il preset del supporto per la sorgente luminosa, che determina come Meshy costruisce la parte inferiore.

Valori disponibili:

• bambu_mh001_60mm: un paralume con fondo aperto e una piastra di base con un foro di fissaggio da 60 mm, entrambi in model_urls.lamp_stl, e il supporto di fissaggio in model_urls.base_stl
• none: un unico paralume sigillato in model_urls.lamp_stl, senza model_urls.base_stl

Di quanto spostare il foro di fissaggio lungo l'asse X rispetto al centro del paralume, in millimetri, da -80 a 80. Si applica solo quando light_source_preset non è none.

Di quanto spostare il foro di fissaggio lungo l'asse Z (profondità) rispetto al centro del paralume, in millimetri, da -80 a 80. Si applica solo quando light_source_preset non è none.

La rotazione attorno all'asse X da applicare al modello prima che Meshy lo elabori, in gradi, da -360 a 360. Meshy applica le tre rotazioni come angoli di Eulero XYZ attorno al centro del modello.

La rotazione attorno all'asse Y da applicare al modello prima che Meshy lo elabori, in gradi, da -360 a 360.

La rotazione attorno all'asse Z da applicare al modello prima che Meshy lo elabori, in gradi, da -360 a 360.

Se aggiungere un file result.json al pacchetto zip, con il nome della pipeline eseguita, gli avvisi e i percorsi dei file. Richiede che output.format sia impostato su zip. true con stl restituisce 400.

I file restituiti dalla build.

Valori disponibili:

• stl: model_urls.lamp_stl, il paralume con la sua piastra di base quando è presente un preset di fissaggio, e model_urls.base_stl quando light_source_preset non è none
• zip: un unico file zip in model_urls.bundle_zip, con lamp.stl, e base.stl e result.json quando applicabili

La richiesta non può essere eseguita. Ad esempio:

• input_task_id è mancante o non è un ID di attività valido.
• Lo stato dell'attività di prototipo non è SUCCEEDED. Se è ancora in esecuzione, attendi e riprova. Se è fallita o è stata annullata, crea una nuova attività di prototipo.
• L'attività di prototipo è riuscita ma non ha alcun modello 3D. Crea una nuova attività di prototipo.
• Un campo di options è fuori intervallo o non è un valore disponibile.
• output.format non è stl né zip, oppure include_result_json è true senza zip.

Il messaggio di errore indica quale problema è stato rilevato.

La chiave API è mancante o non valida. Controlla l'header Authorization.

Si applica una di queste condizioni:

• L'account non ha crediti sufficienti.
• La chiave API, lo spazio di lavoro o il membro ha raggiunto il proprio limite di crediti.
• L'account è sul piano gratuito.

Controlla i tuoi crediti e il tuo piano, quindi riprova.

input_task_id non corrisponde a nessuna attività di prototipo Lamp creata dal tuo account tramite l'API. Anche un prototipo creato nell'app web restituisce 404. Invia l'ID result proveniente da una risposta di creazione del prototipo.

È stato raggiunto uno di questi limiti:

• Hai inviato più richieste di quante ne consenta il tuo limite di frequenza. Attendi qualche secondo, poi riprova. Consulta Limiti di frequenza.
• Troppe tue attività sono in coda o in esecuzione. Attendi che alcune terminino, poi riprova.
• Su un piano illimitato senza crediti residui, hai raggiunto il numero di attività eseguibili senza crediti. Attendi che un'attività termini, oppure aggiungi crediti.

L'ID del task dalla risposta di creazione.

id non è un ID di task valido. Invia l'ID result dalla risposta di creazione.

Il tuo team ha attivato il Filtro IP, e Meshy ha segnalato l'immagine del task di prototipo per proprietà intellettuale di terze parti. I task di build e i team con piano Enterprise non ricevono questo errore. Crea un task di prototipo partendo da un'immagine che hai il diritto di utilizzare.

Nessun task Lamp con questo ID appartiene al tuo account, oppure la fase del task non corrisponde al percorso. Controlla l'ID e usa /prototype o /build in base al task.

Meshy non è riuscito a eseguire il controllo di proprietà intellettuale. Riprova la richiesta.

L'ID dell'attività da annullare.

Si applica uno dei seguenti casi:

• id non è un ID attività valido. Invia l'ID result ottenuto dalla risposta di creazione.
• L'attività ha già uno stato finale (SUCCEEDED, FAILED o CANCELED), quindi non può essere annullata.

Nessuna attività Lamp con questo ID appartiene al tuo account, oppure la fase dell'attività non corrisponde al percorso. Controlla l'ID e usa /prototype o /build per far corrispondere l'attività.

L'ID del task restituito dalla risposta di creazione.

La fase da elencare, prototype o build.

La pagina da restituire, da 1 a 255. 0 restituisce la prima pagina. Un valore al di fuori dell'intervallo 0-255 restituisce 400.

Numero di task per pagina, fino a 100. Un valore da 101 a 255 restituisce 100 task, e 0 utilizza il valore predefinito. Un valore al di fuori dell'intervallo 0-255 restituisce 400.

L'ordine di ordinamento.

Valori disponibili:

• -created_at: prima i più recenti
• +created_at: prima i più vecchi

L'ID del task. Non fare affidamento sul suo formato.

Il tipo di task, sempre creative-lab-lamp-prototype.

Il name inviato al momento della creazione del task, oppure "" se non ne hai inviato uno.

Lo stato del task.

Valori disponibili:

• PENDING: in attesa in coda
• IN_PROGRESS: generazione del risultato in corso
• SUCCEEDED: definitivo, con il risultato
• FAILED: definitivo, con il motivo in task_error
• CANCELED: definitivo, senza risultato

Percentuale di lavoro completato, da 0 a 100. È 0 finché il task non inizia e 100 quando ha successo.

Momento di creazione del task, in millisecondi Unix.

Momento in cui un worker ha avviato il task, in millisecondi Unix. null fino ad allora.

Momento in cui il task ha raggiunto uno stato definitivo, in millisecondi Unix. null fino ad allora.

Momento in cui il risultato del task scade, in millisecondi Unix. Corrisponde a 3 giorni dopo finished_at, oppure a 3 giorni dopo created_at finché il task non termina. Per gli account Enterprise, che conservano i risultati delle API a tempo indeterminato, corrisponde a circa 100 anni dopo. Consulta Conservazione degli asset.

La posizione del task in coda mentre è PENDING. 1 significa che partirà subito dopo. 0 dopo che il task esce dalla coda, e sempre 0 nei risultati di elenco.

Il motivo per cui il task è fallito. null a meno che status non sia FAILED. Consulta Errori.

Numero di crediti addebitati per il task, dopo eventuali rimborsi. Una richiesta che restituisce un errore non viene addebitata. Un task fallito ha valore 0, perché Meshy lo rimborsa. L'annullamento rimborsa un task solo mentre è PENDING. Se Meshy non riesce a leggere l'addebito, una risposta get o stream omette il campo, e una richiesta di elenco restituisce 500. In tal caso, ripeti la richiesta.

URL di download per il modello 3D generato dall'immagine concettuale. {} finché il task non ha successo.

URL di download per un'immagine di anteprima del modello 3D. "" finché il task non ha successo.

URL di download per l'immagine concettuale. L'array contiene un URL dopo il successo del task, ed è vuoto fino ad allora.

L'ID del task. Non fare affidamento sul suo formato.

Il tipo di task, sempre creative-lab-lamp-build.

Il name inviato durante la creazione del task, oppure "" se non ne è stato inviato uno.

Lo stato del task.

Valori disponibili:

• PENDING: in attesa in coda
• IN_PROGRESS: generazione del risultato in corso
• SUCCEEDED: finale, con il risultato
• FAILED: finale, con il motivo in task_error
• CANCELED: finale, senza risultato

Percentuale del lavoro completato, da 0 a 100. È 0 finché il task non inizia e 100 quando ha successo.

Momento in cui il task è stato creato, in millisecondi Unix.

Momento in cui un worker ha avviato il task, in millisecondi Unix. null fino ad allora.

Momento in cui il task ha raggiunto uno stato finale, in millisecondi Unix. null fino ad allora.

Momento in cui il risultato del task scade, in millisecondi Unix. È 3 giorni dopo finished_at, o 3 giorni dopo created_at finché il task non termina. Per gli account Enterprise, che conservano i risultati delle API a tempo indeterminato, è circa 100 anni dopo. Vedi Conservazione degli asset.

La posizione del task in coda mentre è PENDING. 1 significa che inizierà come prossimo. 0 dopo che il task esce dalla coda, e sempre 0 nei risultati di elenco.

Il motivo per cui il task è fallito. null a meno che status non sia FAILED. Vedi Errori.

Numero di crediti addebitati per il task, dopo eventuali rimborsi. Una richiesta che restituisce un errore non viene addebitata. Un task fallito è 0, perché Meshy lo rimborsa. L'annullamento rimborsa un task solo mentre è PENDING. Se Meshy non riesce a leggere l'addebito, una risposta get o stream omette il campo, e una richiesta di elenco restituisce 500. In tal caso, ritenta la richiesta.

URL di download per i file stampabili. Quali chiavi appaiono dipende da output.format e options.light_source_preset.