Ripara stampabilità API

Obbligatorio a meno che non invii model_url. L'ID del task il cui modello vuoi riparare, ad esempio un task Immagine in 3D, Multi-immagine in 3D, Testo in 3D, Remesh, Retexture o Analizza stampabilità. Il task deve essere uno che hai creato con l'API, con stato SUCCEEDED e un modello GLB.

Un task Analizza stampabilità che ha verificato lo spessore parete trasmette anche la sua stampante e dimensione. La riparazione verifica quindi lo spessore parete e ispessisce le pareti sottili, anche se non invii nessuno dei due. Un printer_type o una dimensione di stampa che invii sostituisce quello/a dell'analisi. Un task Analizza stampabilità di un file .stl, .fbx o .gltf da model_url non funziona. Invia invece quel file come model_url.

Obbligatorio a meno che non invii input_task_id. Il modello da riparare, come URL pubblico o data URI. Se invii entrambi, Meshy usa input_task_id.

Da un URL http o https, il modello deve essere un file .glb, .gltf, .obj, .fbx o .stl di al massimo 400 MB. Un data URI può contenere solo un file GLB in base64 (data:model/gltf-binary;base64,...) o glTF (data:model/gltf+json;base64,...) di al massimo 100 MB. Invia un file .obj, .fbx o .stl come URL http o https.

Un file oltre 100 MB deve anche rispettare queste regole:

• Un file GLB, glTF, FBX o OBJ può avere al massimo 10.000.000 facce. Meshy conta le facce come triangoli, quindi un quad conta come 2, e una mesh disegnata più volte conta una volta per copia.
• Un file FBX deve essere FBX binario 7.1 o più recente.
• Un file GLB o glTF non deve usare la compressione Draco.

Un URL di download Meshy (assets.meshy.ai/…?Expires=…&Signature=…) è firmato e smette di funzionare a expires_at del suo task. Rileggere di nuovo il task non lo rinnova. Per un modello che hai creato con Meshy, invia invece input_task_id, che funziona finché Meshy conserva il task sorgente (vedi Conservazione degli asset). Per usare il modello dopo tale scadenza, scaricalo prima di expires_at e invia una tua copia.

Se renderizzare anche un'anteprima con sfondo trasparente (RGBA), restituita in alpha_thumbnail_url quando ottieni il task. thumbnail_url non cambia.

La stampante che prevedi di usare. Imposta lo spessore parete minimo a cui mira la riparazione. Se invii una dimensione di stampa senza printer_type, Meshy usa fdm, a meno che un task Analizza stampabilità in 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

Qualsiasi altro valore restituisce 400.

L'altezza della stampa, in millimetri, da 1 a 1000. Un valore fuori dall'intervallo restituisce 400. Invia questo o intended_print_longest_side_mm, non entrambi.

Funziona solo con input GLB. Per un model_url che non è un file .glb, invia invece intended_print_longest_side_mm.

La lunghezza del lato più lungo della stampa, in millimetri, da 1 a 1000. Un valore fuori dall'intervallo restituisce 400. Funziona con ogni formato di input.

La richiesta non può essere eseguita. Il messaggio di errore indica quale problema ha riscontrato. Ad esempio:

• Parametro mancante: non è stato inviato 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, usa uno schema non supportato o ha un'estensione di file non supportata.
• File del modello troppo grande: il file model_url supera i 400 MB da un URL http o https, oppure supera i 100 MB come data URI.
• Troppe facce: il file model_url è un file GLB, glTF, FBX o OBJ oltre 100 MB con più di 10.000.000 facce. Riduci il numero di facce, poi invia di nuovo il file.
• ASCII FBX oltre 100 MB: il file model_url è un FBX ASCII oltre 100 MB. Inviarlo come FBX binario o GLB.
• File del modello illeggibile: il file model_url supera i 100 MB e Meshy non riesce a leggerne l'header. Ad esempio, è un GLB o glTF compresso con Draco, o un FBX binario antecedente alla 7.1.
• Header del modello troppo complesso: il file model_url supera i 100 MB e il suo header ha troppe mesh, nodi o record da verificare. Riduci il numero di oggetti nel file, poi invialo di nuovo.
• Il file del modello non può essere scaricato: model_url ha restituito un errore, più spesso perché un URL di download Meshy firmato è scaduto. Rileggere di nuovo il task restituisce lo stesso URL con la stessa scadenza. Invia una tua copia del file, oppure invia input_task_id finché Meshy conserva il task sorgente.
• Task non riuscito: il task input_task_id è ancora in attesa, in corso o fallito.
• GLB mancante: il task input_task_id non ha alcun modello GLB da riparare.
• Dimensione di stampa non valida: intended_print_height_mm o intended_print_longest_side_mm è fuori dall'intervallo 1-1000, oppure la richiesta li contiene entrambi.
• Tipo di stampante sconosciuto: printer_type non è fdm, sla o full_color.
• Altezza su un modello non GLB: la richiesta contiene intended_print_height_mm e un model_url che non è un file .glb. Invia 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-1.000 mm. Succede anche quando il modello è piatto, o quando Meshy non riesce a determinarne la dimensione. Invia invece intended_print_longest_side_mm. Per un model_url .glb e alcuni task input_task_id, Meshy lo scopre solo dopo l'avvio del task, e il task termina come FAILED.
• Dimensione STL inutilizzabile: la richiesta contiene printer_type senza una dimensione, e Meshy non riesce a leggere il lato più lungo del file .stl stesso, oppure è fuori dall'intervallo 1-1.000 mm. Invia intended_print_longest_side_mm.

Correggi la richiesta, poi invia nuovamente. Vedi Errori.

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

Ad esempio:

• Crediti insufficienti: l'account non ha crediti sufficienti per questo task, oppure l'account ha raggiunto un limite di crediti. Controlla il tuo saldo crediti, poi riprova.
• Piano gratuito: creare un task richiede un piano a pagamento. Aggiorna il tuo piano nelle impostazioni dell'abbonamento, poi riprova.

input_task_id è un modello bassorilievo, che questo endpoint non può riparare. Il messaggio è This model type does not support this operation. Invia un modello diverso.

Il task input_task_id non esiste o appartiene a un altro utente. Controlla l'ID e usa una chiave API dell'account che ha creato il task.

Hai superato il tuo limite di frequenza, oppure hai troppi task in sospeso. Attendi, poi riprova. Vedi Limiti di frequenza.

L'ID del task dalla risposta di creazione.

L'ID dell'attività da eliminare.

Il numero di pagina da restituire, a partire da 1.

Il numero di attività per pagina, fino a 100.

L'ordinamento.

Valori disponibili:

• +created_at: dalla meno recente
• -created_at: dalla più recente

L'ID del task dalla risposta di creazione.

L'ID del task. Trattalo come una stringa opaca e non fare affidamento sul suo formato.

Il tipo di task, sempre print-repair.

Lo stato del task, uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED o CANCELED.

Quanta parte del task è stata completata, in percentuale. È 0 finché il task non inizia e 100 quando ha successo.

Il numero di task che precedono questo nella coda. Il valore è significativo solo mentre il task è PENDING.

Ora di creazione del task, in millisecondi Unix.

Ora di avvio del task, in millisecondi Unix. È 0 finché il task non inizia.

Ora di completamento del task, in millisecondi Unix. È 0 finché il task non termina.

Ora di scadenza del risultato del task, in millisecondi Unix. È 0 finché il task non termina.

I dettagli dell'errore quando il task fallisce. È null se il task non è fallito. Vedi Errori.

URL di download per il modello riparato. Contiene solo la chiave che corrisponde al formato di input. Un formato che il task non ha generato non ha una chiave, anziché una stringa vuota.

URL di download per un'immagine di anteprima del modello riparato.

URL di download per una versione di thumbnail_url con sfondo trasparente (RGBA). Presente solo quando hai creato il task con alpha_thumbnail: true e Meshy ha renderizzato l'anteprima trasparente.

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

Il numero di crediti utilizzati dal task. È 10 quando il task è SUCCEEDED, e 0 per un task FAILED, perché Meshy rimborsa i crediti quando un task fallisce.

La stampante e le dimensioni utilizzate dalla riparazione, sia che tu le abbia inviate sia che Meshy le abbia riutilizzate da un task Analizza stampabilità. Presente in una riparazione dello spessore parete fin dall'inizio, anche mentre il task è PENDING. Un valore che Meshy non conosce ancora è null.

Cosa ha fatto la riparazione dello spessore parete. Presente dopo che una riparazione dello spessore parete ha successo.