API Analizza 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 e Retexture. L'attività deve utilizzare Meshy 6 o versione successiva (incluso Meshy 7) e deve avere uno stato SUCCEEDED. Sono accettate anche le attività di Ripara stampabilità.

URL di un modello 3D da analizzare. 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 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à di origine viene conservata (vedi Conservazione degli asset). Per riutilizzare un modello dopo tale termine, scaricalo prima di expires_at e invia una tua copia.

La stampante che intendi utilizzare. Imposta lo spessore parete minimo per il controllo dello spessore parete. Il valore predefinito è fdm quando invii una dimensione di stampa senza specificarlo.

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 qualsiasi formato di input.

La richiesta non era accettabile. 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 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, il più delle volte perché un URL di download firmato di Meshy è 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à di origine è ancora conservata.
• Attività non completata con successo: l'attività referenziata è ancora in sospeso, in corso, oppure non riuscita.
• Dimensione di stampa non valida: intended_print_height_mm o intended_print_longest_side_mm è al di fuori di [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 al di fuori di [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 .glb e per alcune attività input_task_id, questo viene rilevato solo dopo l'avvio dell'attività, e l'attività termina con FAILED anziché con un errore immediato.
• Dimensione STL inutilizzabile: printer_type è stato inviato senza una dimensione, e il lato più lungo del file .stl stesso non può essere letto oppure è al di fuori di [1, 1000] mm. Invia intended_print_longest_side_mm.

Autenticazione non riuscita. Controlla la tua chiave API.

L'attività esiste ma appartiene a un altro utente.

Cause comuni:

• L'attività non esiste o è stata eliminata.
• L'attività utilizza un modello precedente a Meshy 6, oppure il suo mode non produce un asset 3D.
• Il file del modello sottostante non è più disponibile nello storage.

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

L'ID del task di analisi della stampabilità da recuperare.

L'ID dell'attività di analisi 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 del task di analisi stampabilità da trasmettere in streaming.

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

Tipo del task analyze-printability. Il valore è print-analyze.

Stato del task. I possibili valori 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 iniziato, questa proprietà sarà 0.

Timestamp di quando il task è terminato, in millisecondi. Se il task non è ancora terminato, 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.

Risultato della valutazione di stampabilità. null finché il task non raggiunge lo stato SUCCEEDED.

Sempre 0. Questo endpoint è gratuito.