API Auto Split

L'ID di un task riuscito il cui modello deve essere diviso. Tipi di task supportati: Immagine in 3D, Multi-immagine in 3D, Testo in 3D (anteprima), Remesh, Converti e Ridimensiona. Il task deve avere stato SUCCEEDED e il suo modello deve essere stato generato con Meshy 6 o Meshy 7 (ai_model meshy-6, meshy-7, meshy-7.1, o latest). I modelli low-poly e Smart Topology (meshy-t2, meshy-t2.5) non sono supportati. Un modello con texture è accettato, ma la sua texture non viene riportata nel risultato.

Come il modello viene diviso in parti.

Valori disponibili:

• auto: Meshy sceglie i tagli. prompt viene ignorato.
• by_parts: Taglia lungo le parti strutturali indicate nel prompt, come testa, braccia e torso.
• by_color: Taglia lungo le regioni di colore indicate nel prompt. Richiede un input generato da un'immagine caricata (Immagine in 3D o Multi-immagine in 3D); altri input vengono rifiutati con 400. I confini delle regioni di colore derivano dall'immagine sorgente, non dalla texture del modello di input. Per Multi-immagine in 3D, Auto Split utilizza la prima immagine sorgente.

Formati in cui esportare il modello diviso. I formati che supportano oggetti scena (glb, obj, fbx, usdz, blend, 3mf) portano ogni parte come oggetto separato; stl non ha il concetto di oggetti separati, quindi fonde ogni parte in un unico solido disposto secondo layout (richiedi 3mf per parti selezionabili separatamente in uno slicer). glb viene sempre prodotto e restituito in model_urls; elenca qualsiasi altro formato desiderato in aggiunta.

Valori disponibili: glb, obj, fbx, stl, usdz, blend, 3mf.

Come le parti sono disposte in ogni formato di output, e nella miniatura.

Valori disponibili:

• assembled: Le parti rimangono dove si trovavano nel modello sorgente.
• on_plate: Le parti vengono adagiate piatte e distribuite sul piano di stampa, pronte per lo slicing — la stessa disposizione della vista On Plate dell'app web.

In entrambi i layout, una scheggia collassata o un pezzo simile a un punto risultante da un taglio viene rimosso prima dell'esportazione, così ogni parte ottenuta è stampabile. I formati che supportano oggetti scena contengono un oggetto per parte; stl li fonde in un unico solido.

Aggiunge connettori a tenone e mortasa a ogni taglio in modo che le parti stampate si incastrino tra loro.

La richiesta non era accettabile. Cause comuni:

• Prompt mancante: prompt è obbligatorio quando mode è by_parts o by_color.
• Il prompt non descrive alcuna divisione, oppure indica troppe parti: by_parts / by_color accetta da 1 a 10 pezzi nominati. Una descrizione che chiede di mantenere il modello in un unico pezzo, o che nomina più di 10 parti, viene rifiutata. Non viene addebitato nulla.
• Task di input non supportato: input_task_id deve fare riferimento a un task riuscito di un tipo supportato, generato con Meshy 6 o Meshy 7.
• Nessuna immagine di riferimento: by_color richiede un input generato da un'immagine caricata.
• Connettore fuori intervallo: connector_size o connector_height è fuori dall'intervallo 0.1 - 0.8.

Autenticazione non riuscita. Verifica la tua chiave API.

Crediti insufficienti per eseguire questo task.

input_task_id non esiste o non appartiene al tuo account.

Hai superato il tuo limite di frequenza. Le richieste by_parts e by_color condividono inoltre un limite di analisi del prompt di 12 richieste al minuto per account.

La divisione basata su prompt (by_parts e by_color) è temporaneamente non disponibile. Riprova più tardi, oppure usa mode: "auto", che non è interessato dal problema. Non viene addebitato nulla.

L'ID del task di Auto Split da recuperare.

L'ID dell'attività di Auto Split da eliminare.

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

Limite della dimensione della pagina. Il valore predefinito è 10 elementi. Il massimo consentito è 100 elementi; valori superiori vengono limitati a 100.

Campo in base al quale 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 Auto Split da trasmettere in streaming.

Identificatore univoco del task. Sebbene utilizziamo uno UUID k-sortable come dettaglio implementativo per gli id dei task, non dovresti fare nessuna assunzione sul formato dell'id.

Tipo del task. Il valore è print-split.

URL scaricabili del modello suddiviso, uno per ciascun formato richiesto. I formati che supportano oggetti scena mantengono ogni parte come oggetto separato; stl le fonde in un unico solido. La proprietà di un formato verrà omessa se il formato non è stato richiesto.

URL scaricabile di un'anteprima renderizzata del modello suddiviso, con ciascuna parte in un colore distinto, nel layout richiesto.

true quando il prompt di una richiesta by_parts o by_color non ha indicato alcuna parte, per cui Meshy ha suddiviso il modello automaticamente — i nomi delle parti nel risultato sono quelli di Meshy, non i tuoi. Presente a partire da PENDING. Omesso per i task auto e ogni volta che il prompt è stato seguito.

Numero di parti stampabili prodotte dallo split. I formati che supportano oggetti scena contengono un oggetto per parte; stl le fonde in un unico solido, e il conteggio continua a riportare il numero delle parti. Le schegge collassate che la segmentazione non è riuscita a trasformare in un pezzo stampabile vengono rimosse dai file prima dell'esportazione e non vengono conteggiate.

Avanzamento del task. Se il task non è ancora iniziato, questa proprietà sarà 0. Una volta che il task è completato con successo, diventerà 100.

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

Il numero di 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 è stato completato, in millisecondi. Se il task non è ancora terminato, questa proprietà sarà 0.

Dettagli dell'errore per i task falliti. Consulta Errori per il riferimento completo dell'oggetto task_error. Se il controllo di sicurezza del fornitore del modello rifiuta il modello in input, il task fallisce con task_error.type invalid_input e code provider_content_refused. Consulta Errori.

Il numero di crediti consumati da questo task. Sempre presente: 10 una volta che il task è stato accettato, e 0 per i task FAILED perché l'addebito viene rimborsato in caso di fallimento. Anche eliminare un task mentre è ancora PENDING ne comporta il rimborso.