API Remesh

L'ID del task Immagine in 3D o Testo in 3D completato che desideri sottoporre a remesh. Questo task deve essere uno dei seguenti: Text to 3D Preview, Text to 3D Refine, Image to 3D o Retexture. Inoltre, deve avere lo stato SUCCEEDED.

Fornisci a Meshy un modello 3D da sottoporre a remesh tramite un URL pubblicamente accessibile o un data URI. Formati supportati: .glb, .gltf, .obj, .fbx, .stl.

Per i Data URI, utilizza il MIME type: application/octet-stream.

Dimensione massima del file: 100 MB.

Un elenco di formati di destinazione per il modello sottoposto a remesh. Se omesso, viene generato solo il GLB.

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

Specifica la topology del modello generato.

Valori disponibili:

• quad: genera una mesh a dominanza di quadrilateri.
• triangle: genera una mesh a triangoli decimata.

Specifica il numero target di poligoni nel modello generato. Il numero effettivo di poligoni può discostarsi dal target a seconda della complessità della geometria.

L'intervallo di valori validi varia in base al livello utente:

• da 100 a 300.000 (inclusi)

Abilita la decimazione adattiva impostando un livello di conteggio poligoni. Quando è impostato, target_polycount viene ignorato.

Valori disponibili:

• 1: Adattivo — conteggio poligoni ultra.
• 2: Adattivo — conteggio poligoni alto.
• 3: Adattivo — conteggio poligoni medio.
• 4: Adattivo — conteggio poligoni basso.

Ridimensiona il modello a una determinata altezza misurata in metri. Consigliamo di utilizzare invece l'API dedicata Resize API.

Ridimensiona il modello in modo che la dimensione più lunga del bounding box sia pari al valore specificato in metri. Consigliamo di utilizzare invece l'API dedicata Resize API.

Quando è impostato su true, il servizio utilizza la visione artificiale AI per stimare automaticamente l'altezza reale dell'oggetto e ridimensionare il modello di conseguenza. Consigliamo di utilizzare invece l'API dedicata Resize API.

Se true, il servizio modificherà solo il formato del file del modello di input, ignorando altri input come topology, resize_height e target_polycount. Consigliamo di utilizzare invece l'API dedicata Convert API.

Quando è impostato su true, il task genera inoltre una versione con sfondo trasparente (RGBA) dell'anteprima e la restituisce come alpha_thumbnail_url nella risposta GET. Il campo esistente thumbnail_url rimane invariato.

La richiesta non è stata accettata. Cause comuni:

• Parametro mancante: deve essere fornito model_url oppure input_task_id.
• Task di input non valido: input_task_id deve fare riferimento a un task completato con successo da un modello supportato.
• Formato del modello non valido: model_url punta a un file con un'estensione non supportata.
• URL non raggiungibile: non è stato possibile scaricare model_url.
• File del modello troppo grande: il file di model_url supera i 100 MB.
• Topology non valida: il parametro topology non è valido.
• Parametri reciprocamente esclusivi: auto_size e resize_height non possono essere entrambi impostati.

Autenticazione non riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questo task.

Hai superato il limite di frequenza.

L'ID dell'attività di remesh da recuperare.

L'ID dell'attività di remesh da eliminare.

Numero di pagina per la paginazione.

Limite della dimensione della pagina. 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 del task di Remesh 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 Remesh. Il valore è remesh.

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

URL scaricabile di un'immagine di anteprima renderizzata dal modello sottoposto a remesh.

URL scaricabile di una versione con sfondo trasparente (RGBA) di thumbnail_url. Presente solo quando il task è stato creato con alpha_thumbnail: true e l'anteprima trasparente è stata renderizzata con successo; altrimenti questo campo viene omesso.

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.

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 stato avviato, questa proprietà sarà 0.

Timestamp di quando il task è stato completato, in millisecondi. Se il task non è ancora stato completato, 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. 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).