Remesh API

L'ID dell'attività Immagine in 3D o Testo in 3D completata che desideri sottoporre a Remesh. Questa attività deve essere una delle seguenti: anteprima Testo in 3D, perfezionamento Testo in 3D, Immagine in 3D o Retexture. Inoltre, deve avere uno stato SUCCEEDED.

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

Per le Data URI, usa il MIME type: application/octet-stream.

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

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

Specifica la topology del modello generato.

Valori disponibili:

• quad: genera una mesh a predominanza di quadrangoli.
• triangle: genera una mesh triangolare 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 valido varia a seconda del 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 invece di usare l'API Ridimensiona dedicata.

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

Quando impostato su true, il servizio usa la visione AI per stimare automaticamente l'altezza reale dell'oggetto e ridimensionare il modello di conseguenza. Consigliamo invece di usare l'API Ridimensiona dedicata.

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

Quando impostato su true, l'attività esegue inoltre il rendering di una versione con sfondo trasparente (RGBA) dell'anteprima e la restituisce come alpha_thumbnail_url nella risposta GET. Il campo thumbnail_url esistente resta invariato.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: è necessario fornire model_url o input_task_id.
• Attività di input non valida: input_task_id deve fare riferimento a un'attività riuscita 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.
• Topology non valida: il parametro topology non è valido.
• Parametri mutuamente esclusivi: auto_size e resize_height non possono essere impostati entrambi.

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 remesh da recuperare.

L'ID del task di remesh da eliminare.

Numero di pagina per la paginazione.

Limite della dimensione della pagina. Il massimo consentito è di 50 elementi.

Campo in base al quale ordinare.

Valori disponibili:

• +created_at: Ordina per ora di creazione in ordine crescente.
• -created_at: Ordina per ora di creazione in ordine decrescente.

Identificatore univoco dell'attività Remesh di cui eseguire lo streaming.

Identificatore univoco per l'attività. Anche se utilizziamo un UUID k-sortable per gli id delle attività come dettaglio di implementazione, non dovresti fare alcuna supposizione sul formato dell'id.

Tipo dell'attività Remesh. Il valore è remesh.

URL scaricabile del file del modello 3D con texture generato da Meshy. La proprietà relativa a un formato verrà 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 l'attività è stata creata con alpha_thumbnail: true e l'anteprima trasparente è stata renderizzata correttamente; in caso contrario, questo campo viene omesso.

progress dell'attività. Se l'attività non è ancora stata avviata, questa proprietà sarà 0. Una volta che l'attività è riuscita, diventerà 100.

Stato dell'attività. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

Il conteggio delle attività precedenti.

timestamp di quando l'attività è stata creata, in millisecondi.

timestamp di quando l'attività è stata avviata, in millisecondi. Se l'attività non è ancora stata avviata, questa proprietà sarà 0.

timestamp di quando l'attività è stata completata, in millisecondi. Se l'attività non è ancora completata, questa proprietà sarà 0.

Dettagli dell'errore per le attività non riuscite. Consulta Errori per il riferimento completo all'oggetto task_error.

Il numero di crediti consumati da questa attività. Presente quando lo stato dell'attività è PENDING, IN_PROGRESS o SUCCEEDED. Restituisce 0 per le attività FAILED (i crediti vengono rimborsati in caso di errore).