Auto Split API

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 stato SUCCEEDED e il suo modello deve essere stato 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 sceglie i tagli. prompt viene ignorato.
• by_parts: Taglia lungo le parti strutturali indicate in prompt, ad esempio testa, braccia e busto.
• by_color: Taglia lungo le regioni di colore indicate 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 suddiviso. Ogni parte è un oggetto separato in ogni formato. glb viene sempre prodotto e restituito in model_urls; elenca eventuali altri formati desiderati in aggiunta.

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

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

Valori disponibili:

• assembled: Le parti restano dove le aveva collocate il modello sorgente.
• on_plate: Le parti vengono adagiate 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 nient'altro: un frammento appiattito o un pezzo simile a un punto risultante da un taglio viene rimosso prima dell'esportazione, quindi ogni oggetto presente nel file è stampabile.

Aggiunge connettori a incastro (a maschio e femmina) su ogni taglio, così le parti stampate combaciano 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. Per ora 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 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 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) è temporaneamente non 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 utilizziamo un UUID k-sortable per gli id dei task come dettaglio implementativo, non dovresti fare alcuna ipotesi sul formato dell'id.

Tipo del task. Il valore è print-split.

URL scaricabili per il modello suddiviso, uno per ogni formato richiesto. Ogni parte è un oggetto separato all'interno del file. La proprietà per un formato viene omessa se il 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 nominava alcuna parte, quindi 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 nel modello suddiviso — una per ogni 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.

Progresso 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 valori possibili 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 è 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 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. Anche l'eliminazione di un task mentre è ancora PENDING comporta il rimborso.