API Auto Split

L'ID dell'attività il cui modello deve essere suddiviso. L'attività deve avere lo stato SUCCEEDED. Questi tipi di attività funzionano:

• Immagine in 3D
• Multi-immagine in 3D
• Testo in 3D, un'attività preview o refine
• Retexture
• Remesh
• Converti
• Ridimensiona

Il modello deve essere generato con Meshy 6 o Meshy 7, ovvero con ai_model impostato su meshy-6-lite, meshy-6, meshy-7, meshy-7.1, o latest. I modelli Smart Topology (meshy-t2 e meshy-t2.5) non sono supportati. Per un'attività refine, Retexture, Remesh, Converti o Ridimensiona, la regola si applica al modello da cui l'attività è partita. Un'attività Retexture, Remesh, Converti o Ridimensiona creata a partire da un modello caricato restituisce 400.

Il modello può avere al massimo 8.000.000 di facce. Un modello con più facce restituisce 400. In tal caso, esegui prima un'attività Remesh su di esso e invia invece l'ID dell'attività Remesh.

Puoi suddividere un modello con texture. Per mantenerne la texture sulle parti, invia keep_texture: true.

Come dividere il modello in parti.

Valori disponibili:

• auto: Meshy sceglie i tagli e ignora prompt. Un prompt di oltre 600 caratteri restituisce comunque 400.
• by_parts: Meshy taglia lungo le parti strutturali che nomini in prompt, ad esempio testa, braccia e torso.
• by_color: Meshy taglia lungo le regioni di colore che nomini in prompt. Meshy individua le regioni nell'immagine sorgente, non nella texture del modello di input. L'input deve essere generato da un'immagine caricata, con Immagine in 3D o Multi-immagine in 3D. Altri input restituiscono 400. Per Multi-immagine in 3D, Meshy usa la prima immagine sorgente.

I formati di file da generare. Meshy genera sempre glb e lo restituisce in model_urls, oltre agli altri formati che elenchi.

Valori disponibili:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Ogni formato tranne stl supporta gli oggetti scena e mantiene ciascuna parte come oggetto separato. Un file STL non può contenere oggetti separati, quindi Meshy fonde le parti in un unico solido, disposto secondo layout. Per ottenere parti selezionabili separatamente in uno slicer, richiedi 3mf.

Con keep_texture: true, questi formati mantengono la texture:

• glb, fbx, usdz e blend: La texture è nel file.
• obj: La texture è nel file materiale, che model_urls restituisce sotto mtl.
• stl e 3mf: Il file contiene solo la geometria, senza la texture.

Come Meshy dispone le parti, in ogni formato di file e nella miniatura.

Valori disponibili:

• assembled: Meshy mantiene le parti dove si trovavano nel modello sorgente.
• on_plate: Meshy appiattisce le parti e le distribuisce sul piatto di stampa, pronte per lo slicing. Questa disposizione è la stessa della vista On Plate nell'app web.

In entrambe le disposizioni, Meshy rimuove prima dell'esportazione qualsiasi frammento collassato o simile a un punto lasciato da un taglio, così ogni parte ottenuta è stampabile. I formati che supportano gli oggetti scena contengono un oggetto per parte, e stl fonde le parti in un unico solido.

Se mantenere la texture del modello di input sulle parti. true assegna a ogni parte la texture dell'input, e l'attività restituisce le mappe in texture_urls. false assegna a ciascuna parte un colore vertice uniforme.

Con true, l'attività richiede circa il doppio del tempo, e il costo in crediti non cambia. Un input senza texture viene suddiviso allo stesso modo che con false. Se Meshy non riesce a mantenere la texture, l'attività fallisce con il codice di errore textured_split_refused. Consulta Errori.

Se aggiungere connettori a incastro (maschio-femmina) a ogni taglio, in modo che le parti stampate si incastrino tra loro.

La richiesta non può essere eseguita. Il messaggio di errore indica quale problema è stato rilevato. Ad esempio:

• Prompt mancante: mode è by_parts o by_color, e prompt manca.
• Il prompt non descrive alcuna suddivisione, o nomina troppe parti: Il prompt chiede di mantenere il modello in un unico pezzo, oppure nomina più di 10 parti. by_parts e by_color accettano da 1 a 10 parti nominate. Meshy non addebita nulla per la richiesta.
• Attività di input non supportata: input_task_id non è un'attività completata con successo di un tipo supportato, generata con Meshy 6 o Meshy 7.
• Nessuna immagine di riferimento: mode è by_color, e l'input non è stato generato da un'immagine caricata.
• Connettore fuori intervallo: connector_size o connector_height è fuori dall'intervallo 0.1-0.8.

Correggi la richiesta, quindi inviala di nuovo. Consulta Errori.

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

Ad esempio:

• Crediti insufficienti: L'account non ha crediti sufficienti per questa attività, oppure ha raggiunto un limite di crediti. Controlla il tuo saldo crediti, quindi riprova.
• Piano gratuito: Creare un'attività richiede un piano a pagamento. Aggiorna il tuo piano nelle impostazioni dell'abbonamento, quindi riprova.

Si applica una di queste condizioni:

• La moderazione dei contenuti ha bloccato il prompt. Il messaggio è explicit content o prohibited content. Modifica il prompt, quindi riprova.
• input_task_id è un modello a bassorilievo, che questo endpoint non può suddividere. Il messaggio è This model type does not support this operation. Invia un modello diverso.

input_task_id non esiste o non appartiene al tuo account. Controlla l'ID e usa una chiave API dell'account che ha creato l'attività.

Hai superato il tuo limite di frequenza. Attendi, quindi riprova. Consulta Limiti di frequenza.

Le richieste by_parts e by_color condividono inoltre un limite di lettura del prompt di 12 richieste al minuto per account.

La suddivisione tramite prompt (by_parts e by_color) è temporaneamente non disponibile. Riprova più tardi, oppure invia mode: "auto", che funziona comunque. Meshy non addebita nulla per la richiesta.

L'ID del task ottenuto dalla risposta di creazione.

L'ID dell'attività da eliminare.

Il numero di pagina da restituire. Inizia e assume come valore predefinito 1.

Il numero di task per pagina, fino a 100. Il valore predefinito è 10. Meshy tratta un valore più grande come 100.

L'ordine di ordinamento.

Valori disponibili:

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

L'ID del task restituito 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-split.

URL di download per il modello suddiviso, uno per ogni formato richiesto. Un formato non richiesto non ha una chiave corrispondente. I formati che supportano oggetti scena mantengono ogni parte come oggetto separato, mentre stl fonde le parti in un unico solido.

URL di download per un'immagine di anteprima del modello suddiviso, nel layout richiesto. Quando le parti mantengono una texture, l'anteprima la mostra. Altrimenti, ogni parte ha il proprio colore.

Le mappe texture del modello suddiviso, come array contenente un oggetto. Tutte le parti condividono queste mappe. Presente solo quando keep_texture è true e il modello di input è texturizzato.

URL di download per una versione di thumbnail_url con sfondo trasparente (RGBA). Presente solo dopo che il task ha avuto esito positivo, quando Meshy ha renderizzato l'anteprima trasparente.

Indica se Meshy ha ignorato il prompt. È true quando il prompt di una richiesta by_parts o by_color non nominava alcuna parte, per cui Meshy ha suddiviso il modello automaticamente. In tal caso, i nomi delle parti nel risultato sono quelli assegnati da Meshy, non i tuoi. Presente a partire da PENDING. Meshy lo omette per i task auto e ogni volta che ha seguito il prompt.

Il numero di parti stampabili prodotte dalla suddivisione. I formati che supportano oggetti scena contengono un oggetto per parte. stl fonde le parti in un unico solido, ma part_count le conteggia comunque. Prima dell'esportazione, Meshy rimuove le schegge collassate che non possono diventare una parte stampabile, e non le conteggia.

Quanto del task è stato completato, in percentuale. È 0 finché il task non inizia e 100 quando ha esito positivo.

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

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 conclusione 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. Vedi Errori.

Se un controllo di sicurezza rifiuta il modello di input, il task fallisce con task_error.type impostato su invalid_input e task_error.code impostato su provider_content_refused. Invia un modello diverso. Vedi Errori.

Con keep_texture: true, se Meshy non riesce a mantenere la texture, il task fallisce con task_error.code impostato su textured_split_refused. Vedi Errori.

Il numero di crediti utilizzati dal task. È sempre presente. È 10 dopo che Meshy accetta il task, e 0 per un task FAILED, perché Meshy rimborsa i crediti quando un task fallisce. Anche l'eliminazione di un task PENDING lo rimborsa.