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: Testo in 3D Preview, Testo in 3D Refine, Immagine in 3D o Retexture. Inoltre, deve avere uno stato SUCCEEDED.

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

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

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

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

Specifica il topology del modello generato.

Valori disponibili:

• quad: Genera una mesh a dominanza di quadrilateri.
• triangle: Genera una mesh triangolare decimata.

Specifica il numero di poligoni di destinazione nel modello generato. Il numero effettivo di poligoni potrebbe discostarsi dall'obiettivo in base alla complessità della geometria.

L'intervallo di valori validi 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 di utilizzare l'API dedicata Resize API.

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

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

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 di utilizzare 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: È necessario fornire model_url oppure input_task_id.
• Task di input non valido: input_task_id deve fare riferimento a un task completato con successo di 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 il file da model_url.
• Topology non valido: 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 questo task.

Hai superato il tuo 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).