API Ripara stampabilità

L'ID di un'attività completata con successo di tua proprietà. Tipi di attività supportati: Immagine in 3D, Multi-immagine in 3D, Testo in 3D, Remesh, Retexture e Analizza stampabilità. L'attività deve avere stato SUCCEEDED e deve aver prodotto un asset GLB.

Un'attività di analisi che ha verificato lo spessore parete trasmette anche il tipo di stampante e la dimensione utilizzati, quindi la riparazione verifica lo spessore parete e ispessisce le pareti sottili anche se non invii nessuno dei due; un printer_type o una dimensione di stampa inviati sovrascrivono quel valore. Le attività di analisi create da un model_url di tipo .stl, .fbx o .gltf non sono accettate: invia invece il file come model_url.

URL di un modello 3D da riparare. Formati supportati: .glb, .gltf, .obj, .fbx, .stl. Dimensione massima del file: 100 MB. Deve utilizzare http, https, oppure un URL data: (gli URL data bypassano i controlli sull'estensione).

Gli URL di download di Meshy (assets.meshy.ai/…?Expires=…&Signature=…) sono firmati e smettono di funzionare alla scadenza expires_at dell'attività; recuperare nuovamente l'attività non li rinnova. Per un modello generato con Meshy, invia invece input_task_id. Funziona finché l'attività sorgente viene conservata (vedi Conservazione degli asset). Per riutilizzare un modello dopo tale scadenza, scaricalo prima di expires_at e invia una tua copia.

Se impostato su true, l'attività genera inoltre una versione con sfondo trasparente (RGBA) dell'anteprima e la restituisce come alpha_thumbnail_url nella risposta GET. Il campo esistente thumbnail_url rimane invariato.

La stampante che intendi utilizzare. Determina lo spessore parete minimo a cui mira la riparazione. Il valore predefinito è fdm quando invii una dimensione di stampa senza specificarlo, a meno che un'attività di analisi passata come input_task_id non fornisca la stampante.

Valori disponibili:

• fdm: filamento, spessore parete minimo 1,0 mm.
• sla: resina, spessore parete minimo 0,8 mm.
• full_color: a colori, spessore parete minimo 2,0 mm.

Altezza della stampa, in millimetri. Intervallo: [1, 1000]. Arrotondato al millimetro più vicino. Solo per input GLB.

Lunghezza del lato più lungo della stampa, in millimetri. Intervallo: [1, 1000]. Arrotondato al millimetro più vicino. Funziona con tutti i formati di input.

La richiesta non è stata accettata. Cause comuni:

• Parametro mancante: non è stato fornito né input_task_id né model_url.
• UUID non valido: input_task_id non è un UUID valido.
• URL del modello non valido: model_url è malformato, utilizza uno schema non supportato oppure ha un'estensione di file non supportata.
• File del modello troppo grande: il corpo di model_url ha superato i 100 MB.
• Impossibile scaricare il file del modello: model_url ha restituito un errore, più spesso perché un URL di download Meshy firmato è scaduto. Recuperare nuovamente l'attività restituisce lo stesso URL con la stessa scadenza, quindi invia una tua copia del file, oppure usa input_task_id finché l'attività sorgente è ancora conservata.
• Attività non completata con successo: l'attività referenziata è ancora in sospeso, in corso oppure fallita.
• GLB mancante: l'attività referenziata non ha un asset GLB da riparare.
• Dimensione di stampa non valida: intended_print_height_mm o intended_print_longest_side_mm è fuori dall'intervallo [1, 1000], oppure sono stati inviati entrambi.
• Tipo di stampante sconosciuto: printer_type non è fdm, sla o full_color.
• Altezza su un modello non GLB: intended_print_height_mm è stato inviato con un model_url che non è .glb. Usa invece intended_print_longest_side_mm.
• Impossibile dimensionare questo modello in base all'altezza: all'altezza richiesta (o al valore predefinito di 150 mm), il lato più lungo del modello risulterebbe fuori dall'intervallo [1, 1000] mm, il modello è piatto, oppure la sua dimensione non può essere determinata. Usa invece intended_print_longest_side_mm. Per un model_url di tipo .glb e alcune attività con input_task_id, questo viene rilevato solo dopo l'avvio dell'attività, che termina invece con stato FAILED.
• Dimensione STL inutilizzabile: printer_type è stato inviato senza una dimensione, e il lato più lungo del file .stl non può essere letto oppure è fuori dall'intervallo [1, 1000] mm. Invia intended_print_longest_side_mm.

Autenticazione non riuscita. Verifica la tua chiave API.

Cause comuni:

• Piano gratuito: la creazione di attività richiede un piano a pagamento. Esegui l'upgrade dalla pagina dell'abbonamento.
• Crediti insufficienti: è stato raggiunto il limite di crediti dello spazio di lavoro.

L'attività referenziata non esiste oppure appartiene a un altro utente.

Hai superato la quota di attività in sospeso o il limite di frequenza.

L'ID del task di riparazione-stampabilità da recuperare.

L'ID dell'attività di riparazione della stampabilità da eliminare.

Numero di pagina per la paginazione. Inizia e ha come valore predefinito 1.

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

Campo su cui ordinare. Valori disponibili:

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

Identificatore univoco dell'attività di riparazione della stampabilità da trasmettere in streaming.

Identificatore univoco del task. Sebbene si utilizzi uno UUID k-sortable per gli id dei task come dettaglio implementativo, non si dovrebbero fare assunzioni sul formato dell'id.

Tipo del task di repair-printability. Il valore è print-repair.

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

Progress del task. Se il task non è ancora iniziato, questa proprietà sarà 0. Una volta che il task è andato a buon fine, diventerà 100.

Il conteggio dei task precedenti.

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

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

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

Timestamp di quando il risultato del task scadrà dal sistema, in millisecondi. 0 se il task non è ancora terminato.

Informazioni sull'errore se il task è fallito. Questa proprietà è null se il task non è fallito. Vedi Errori per maggiori dettagli.

URL scaricabili per il modello 3D riparato. Solo il campo corrispondente al formato di input viene popolato; gli altri campi di formato sono stringhe vuote.

URL di un'immagine di anteprima renderizzata dal modello riparato.

URL scaricabile per una versione con sfondo trasparente (RGBA) di thumbnail_url. Presente solo quando il task è stato creato con alpha_thumbnail: true e l'anteprima trasparente è stata renderizzata con successo; altrimenti questo campo è omesso.

Sempre un array vuoto. La riparazione preserva solo la geometria di input e non ricrea le texture.

Il numero di crediti consumati da questo task. 10 una volta che il task ha raggiunto lo stato SUCCEEDED. Restituisce 0 per i task FAILED (i crediti vengono rimborsati in caso di fallimento).

La stampante e la dimensione utilizzate dalla riparazione, sia che siano state inviate sia che siano state riutilizzate da un task di analisi. Presente in una riparazione dello spessore parete fin dall'inizio (PENDING); i valori non ancora noti sono null.

Cosa ha fatto la riparazione dello spessore parete. Presente una volta che una riparazione dello spessore parete è andata a buon fine.