API di Auto Split

L'ID di un'attività riuscita il cui modello deve essere diviso. Tipi di attività supportati: Immagine in 3D, Multi-immagine in 3D, Testo in 3D (anteprima), Remesh, Converti e Ridimensiona. L'attività deve avere lo stato SUCCEEDED e il suo modello deve essere generato con Meshy 6 o Meshy 7 (ai_model meshy-6, meshy-7, o latest). I modelli low-poly e Smart Topology (meshy-t2) non sono supportati.

Come il modello viene diviso in parti.

Valori disponibili:

• auto: Meshy scelge i tagli. prompt viene ignorato.
• by_parts: Taglia lungo le parti strutturali che nomini in prompt, come testa, braccia e busto.
• 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.

Formati in cui esportare il modello diviso. Ogni parte è un oggetto separato in ogni formato. glb viene sempre prodotto e restituito in model_urls; elenca eventuali altri formati che desideri in aggiunta.

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

3mf viene scritto per gli slicer: un oggetto per parte, ciascuno sul proprio slot filamento, così Bambu Studio apre il file come parti colorate individualmente e selezionabili separatamente (l'archivio contiene una configurazione di progetto Bambu Studio; altri slicer leggono la geometria). Come gli altri formati di stampa di Meshy, è in millimetri e, poiché questo endpoint non richiede una dimensione target, l'intero modello viene ridimensionato in modo che il lato più lungo sia 150 mm — lo stesso limite usato dagli altri export in formato di stampa, scelto per adattarsi a ogni piano di stampa mainstream. Con layout: "on_plate" il limite si applica al piano disposto nel suo insieme, quindi il file è pronto per lo slicing; con assembled, le parti restano dove si trovavano nel modello di origine e le disponi tu nello slicer.

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

Valori disponibili:

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

In entrambe le disposizioni i file esportati contengono un oggetto per parte e nulla altro: una scheggia collassata o un pezzo simile a un punto residuo di un taglio viene rimosso prima dell'esportazione, quindi ogni oggetto che trovi nel file è stampabile.

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

La richiesta non è stata accettata. Cause comuni:

• Prompt mancante: prompt è obbligatorio quando mode è by_parts o by_color.
• Il prompt nomina meno di due parti: by_parts / by_color richiede almeno due pezzi nominati (ad esempio head, torso, base); un'istruzione generica come split into individual parts 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.
• Input con texture: il modello di input ha texture. Al momento sono supportati solo modelli senza texture.
• Nessuna immagine di riferimento: by_color richiede un input generato da un'immagine caricata.
• Formato non supportato: target_formats contiene stl.
• Connettore fuori intervallo: connector_size o connector_height è fuori dall'intervallo da 0.1 a 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 suddivisione basata su prompt (by_parts e by_color) non è temporaneamente disponibile. Riprova più tardi, oppure usa mode: "auto", che non è interessato dal problema. Non viene addebitato nulla.

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

L'ID dell'attività 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; 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 dell'attività Auto Split da trasmettere in streaming.

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

Tipo del task. Il valore è print-split.

URL scaricabili per il modello suddiviso, uno per ciascun formato richiesto. Ogni parte è un oggetto separato all'interno del file. La proprietà per un formato viene omessa se quel formato non è stato richiesto.

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

true quando il prompt di una richiesta by_parts o by_color non indicava 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 nel modello suddiviso — una per ciascun oggetto nei file esportati. 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 è riuscito, 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 stato avviato, 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.

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