API Analizza stampabilità

Obbligatorio a meno che tu non invii model_url. L'ID dell'attività il cui modello vuoi analizzare. L'attività deve avere lo stato SUCCEEDED ed essere tua o appartenere a uno spazio di lavoro a cui appartieni.

Può essere uno di questi tipi di attività, usando Meshy 6 o versioni successive, incluso Meshy 7:

• Immagine in 3D
• Multi-immagine in 3D
• Testo in 3D
• Remesh
• Retexture

Funziona anche un'attività di Ripara stampabilità.

Obbligatorio a meno che tu non invii input_task_id. Il modello da analizzare, 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 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 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 quadrilatero 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 al expires_at della sua attività. Rileggere di nuovo l'attività non lo rinnova. Per un modello che hai creato con Meshy, invia invece input_task_id, che funziona finché Meshy conserva l'attività sorgente (vedi Conservazione degli asset). Per usare il modello dopo quel momento, scaricalo prima di expires_at e invia la tua copia.

La stampante che prevedi di usare. Imposta lo spessore parete minimo per il controllo dello spessore parete. Se invii una dimensione di stampa senza printer_type, Meshy usa fdm.

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 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.
• FBX ASCII 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 precedente alla versione 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.
• File del modello non scaricabile: model_url ha restituito un errore, più spesso perché un URL di download Meshy firmato è scaduto. Rileggere di nuovo l'attività restituisce lo stesso URL con la stessa scadenza. Invia la tua copia del file, oppure invia input_task_id finché Meshy conserva l'attività sorgente.
• Attività non riuscita: L'attività input_task_id è ancora in attesa, in corso, o fallita.
• Dimensione di stampa non valida: intended_print_height_mm o intended_print_longest_side_mm è fuori dall'intervallo 1 a 1000, oppure la richiesta 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 per altezza: All'altezza richiesta, o al valore predefinito di 150 mm, il lato più lungo del modello sarebbe fuori dall'intervallo da 1 a 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 alcune attività input_task_id, Meshy lo scopre solo dopo l'avvio dell'attività, e l'attività termina come FAILED invece.
• Dimensione STL inutilizzabile: La richiesta contiene printer_type senza una dimensione, e Meshy non riesce a leggere il lato più lungo proprio del file .stl, oppure è fuori dall'intervallo da 1 a 1.000 mm. Invia intended_print_longest_side_mm.

Correggi la richiesta, poi invala di nuovo. Vedi Errori.

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

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

Meshy non riesce a trovare un modello da analizzare per input_task_id. Ad esempio:

• L'attività non esiste, è stata eliminata, o non è tua o non appartiene a uno spazio di lavoro a cui appartieni.
• L'attività usa un modello più vecchio di Meshy 6, oppure il suo tipo non produce un modello 3D.
• Il file del modello dell'attività non è più presente nello storage.

Verifica che input_task_id sia un'attività supportata che è tua o appartiene a uno dei tuoi spazi di lavoro, oppure invia il modello come model_url.

Hai superato il tuo limite di frequenza, oppure hai troppe attività in attesa. Attendi, poi riprova. Vedi Limiti di frequenza.

L'ID dell'attività 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: dal più vecchio
• -created_at: dal 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-analyze.

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

Quanto del task è stato completato, 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 in cui il task è stato creato, in millisecondi Unix.

Ora in cui il task è iniziato, in millisecondi Unix. È 0 finché il task non inizia.

Ora in cui il task è terminato, in millisecondi Unix. È 0 finché il task non termina.

Ora in cui il risultato del task scade, 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.

Il risultato dell'analisi. Non è presente finché il task non è SUCCEEDED.

Il numero di crediti usati dal task. È sempre 0, perché l'analisi è gratuita.