API di Auto Split

L'ID di un'attività riuscita il cui modello dividere. Tipi di attività supportati: Immagine in 3D, Multi-immagine in 3D, Testo in 3D (anteprima), Remesh, Converti e Ridimensiona. L'attività deve avere uno stato SUCCEEDED, e il suo modello deve essere 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) non sono supportati. Un modello con texture è accettato, e la sua texture non viene riportata nel risultato.

Come il modello viene diviso in parti.

Valori disponibili:

• auto: Meshy scegli i tagli. prompt viene ignorato.
• by_parts: Taglia lungo le parti strutturali che nomini in prompt, come testa, braccia e torso.
• by_color: Taglia lungo le regioni di colore che nomini in 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 provengono dall'immagine di origine, non dalla texture del modello di input. Per Multi-immagine in 3D, Auto Split usa la prima immagine di origine.

Formati in cui esportare il modello diviso. I formati che supportano oggetti di 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 che desideri 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 le aveva il modello di origine.
• 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 entrambe le disposizioni una scheggia collassata o un frammento simile a un punto rimasto da un taglio viene rimosso prima dell'esportazione, così ogni parte che ottieni è stampabile. I formati che supportano oggetti di scena contengono un oggetto per parte; stl li fonde in un unico solido.

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

La richiesta era inaccettabile. Cause comuni:

• Prompt mancante: prompt è obbligatorio quando mode è by_parts o by_color.
• Il prompt non descrive alcuna divisione, o troppe parti: by_parts / by_color accetta da 1 a 10 pezzi nominati. Una descrizione che chiede di mantenere il modello in un solo pezzo, o che nomina più di 10 parti, viene rifiutata. Non viene addebitato nulla.
• Attività di input non supportata: input_task_id deve fare riferimento a un'attività riuscita di un tipo supportato, generata 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. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività.

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 anche 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 è influenzato. 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 di dimensione della pagina. Il valore predefinito è 10 elementi. Il massimo consentito è 100 elementi; i valori più grandi 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 dell'attività di Auto Split da trasmettere in streaming.

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

Tipo del task. Il valore è print-split.

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

URL scaricabile per 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 nominava alcuna parte, per cui Meshy ha suddiviso il modello automaticamente — i nomi delle parti nel risultato sono quelli assegnati da 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 ogni parte; stl le fonde in un unico solido, ma il conteggio continua a riportare le 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 è andato a buon fine, diventerà 100.

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

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.

Dettagli dell'errore per i task falliti. Consulta Errori per il riferimento completo all'oggetto task_error.

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. Eliminare un task mentre è ancora PENDING lo rimborsa anch'esso.