API di Remesh

L'ID del task completato Immagine in 3D o Testo in 3D che desideri remeshare. Questo task deve essere uno dei seguenti: Testo in 3D Anteprima, Testo in 3D Raffina, Immagine in 3D o Retexture. Inoltre, deve avere uno stato di SUCCEEDED.

Fornisci un modello 3D per Meshy da remeshare 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.

Una lista di formati target per il modello remeshato. Quando 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 dominante quad.
• triangle: Genera una mesh triangolare decimata.

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

L'intervallo di valori validi varia a seconda del livello utente:

• 100 a 300,000 (inclusivo)

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

Valori disponibili:

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

Ridimensiona il modello a una certa altezza misurata in metri. Raccomandiamo di utilizzare la Resize API dedicata.

Ridimensiona il modello in modo che la dimensione più lunga della bounding-box sia uguale al valore specificato in metri. Raccomandiamo di utilizzare la Resize API dedicata.

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

Se true, il servizio cambierà solo il formato del file modello di input, ignorando altri input come topology, resize_height, e target_polycount. Raccomandiamo di utilizzare la Convert API dedicata.

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

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: Devono essere forniti model_url o input_task_id.
• Task di input non valido: L'input_task_id deve riferirsi a un task riuscito da un modello supportato.
• Formato modello non valido: Il model_url punta a un file con un'estensione non supportata.
• URL irraggiungibile: Il model_url non può essere scaricato.
• Topology non valida: Il parametro topology non è valido.
• Parametri mutuamente esclusivi: auto_size e resize_height non possono essere entrambi impostati.

Autenticazione fallita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questo task.

Hai superato il tuo limite di frequenza.

L'ID del task 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 è di 50 elementi.

Campo per ordinare.

Valori disponibili:

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

Identificatore univoco per il task di Remesh da trasmettere.

Identificatore univoco per il compito. Anche se utilizziamo un UUID ordinabile per id dei compiti come dettaglio di implementazione, non dovresti fare alcuna ipotesi sul formato dell'id.

Tipo del compito 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 è generato invece di restituire una stringa vuota.

URL scaricabile di un'immagine di anteprima renderizzata dal modello rimodellato.

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

Avanzamento del compito. Se il compito non è ancora iniziato, questa proprietà sarà 0. Una volta che il compito è riuscito, diventerà 100.

Stato del compito. I valori possibili sono uno di PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

Il conteggio dei compiti precedenti.

Timestamp di quando il compito è stato creato, in millisecondi.

Timestamp di quando il compito è iniziato, in millisecondi. Se il compito non è ancora iniziato, questa proprietà sarà 0.

Timestamp di quando il compito è terminato, in millisecondi. Se il compito non è ancora terminato, questa proprietà sarà 0.

Dettagli dell'errore per i compiti falliti. Vedi Errori per il riferimento completo all'oggetto task_error.

Il numero di crediti consumati da questo compito. Presente quando lo stato del compito è PENDING, IN_PROGRESS, o SUCCEEDED. Restituisce 0 per i compiti FAILED (i crediti sono rimborsati in caso di fallimento).