API di stampa multicolore

L'ID di un'attività riuscita da usare come input. Tipi di attività supportati: Immagine in 3D, Multi-immagine in 3D, Testo in 3D, Remesh e Retexture. L'attività deve avere uno stato SUCCEEDED.

URL pubblicamente accessibile o Data URI di un modello 3D. Attualmente supportiamo i formati .glb e .fbx.

Numero massimo di colori nella palette di output.

Intervallo valido: da 1 a 16.

Stile visivo dei colori del file 3MF generato.

Valori disponibili:

• realistic: campiona i colori direttamente dalla texture del modello per un dettaglio fine e fotorealistico. Produce un file più grande.
• cartoon: appiattisce i colori in regioni uniformi e pulite per un aspetto stilizzato. Produce un file più piccolo.

L'input deve contenere informazioni sul colore: realistic richiede una singola texture di colore base con coordinate UV su ogni parte della mesh; cartoon accetta anche colori per vertice. I modelli senza texture (bianchi) vengono rifiutati — vedi model_missing_texture.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: deve essere fornito model_url oppure input_task_id.
• Formato del modello non valido: model_url punta a un file con un'estensione non supportata (sono supportati solo .glb e .fbx).
• URL non raggiungibile: non è stato possibile scaricare model_url.
• Attività di input non valida: input_task_id deve fare riferimento a un'attività riuscita.
• max_colors non valido: il valore deve essere compreso tra 1 e 16.
• style non valido: il valore deve essere realistic o cartoon.
• Nessuna sorgente di colore: il modello di input non ha una texture di colore base (realistic ne richiede una singola, con UV, su ogni parte della mesh) né colori per vertice (cartoon accetta entrambi). Applica prima una texture al modello, oppure usa cartoon per i modelli con colori per vertice. I caricamenti .fbx vengono verificati dopo che l'attività li normalizza e falliscono con model_missing_texture invece.

Autenticazione non riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività.

Hai superato il tuo limite di frequenza.

L'ID dell'attività di stampa 3D da recuperare.

L'ID dell'attività di stampa 3D multicolore 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.

Campo su cui 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 stampa 3D multicolore da trasmettere in streaming.

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

Tipo del task di stampa 3D. Il valore è print-multi-color.

URL scaricabile del file del modello 3D generato da Meshy. La proprietà per un formato verrà omessa se il formato non viene generato, invece di restituire una stringa vuota.

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 valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

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 è 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. Presente quando lo stato del task è PENDING, IN_PROGRESS o SUCCEEDED. Restituisce 0 per i task FAILED (i crediti vengono rimborsati in caso di fallimento).