Remesh API

Obbligatorio a meno che tu non invii model_url. L'ID del task il cui modello vuoi sottoporre a remesh, ad esempio un task di Testo in 3D, Immagine in 3D, Retexture o Remesh. Il task deve essere uno creato da te con l'API e avere lo stato SUCCEEDED.

Obbligatorio a meno che tu non invii input_task_id. Il modello da sottoporre a remesh, come URL pubblico o data URI. Se invii entrambi, Meshy usa input_task_id.

Il modello deve essere un file GLB, glTF, OBJ, FBX o STL di al massimo 400 MB da un URL http o https, oppure 100 MB come data URI. Per un data URI, usa il MIME type application/octet-stream.

Un file oltre i 100 MB deve inoltre rispettare queste regole:

• Un file GLB, glTF, FBX o OBJ può avere al massimo 10.000.000 di facce. Meshy conta le facce come triangoli, quindi un quad conta come 2, e una mesh disegnata più volte conta una volta per copia.
• Un file FBX deve essere binario FBX 7.1 o più recente.
• Un file GLB o glTF non deve usare la compressione Draco.

I formati di file da generare.

Valori disponibili:

• glb
• fbx
• obj
• usdz
• blend
• stl
• 3mf

Il tipo di faccia del modello sottoposto a remesh.

Valori disponibili:

• quad: una mesh a predominanza di quad
• triangle: una mesh triangolare decimata

Il numero di facce da ottenere come obiettivo, da 100 a 300000. Il risultato può differire dall'obiettivo, a seconda della geometria del modello. Un valore fuori dall'intervallo restituisce 400.

Conteggio adattivo delle facce, per livello. Quando lo imposti, Meshy ignora target_polycount.

Valori disponibili:

• 1: ultra
• 2: alto
• 3: medio
• 4: basso

Usa invece la Resize API. L'altezza a cui ridimensionare il modello, in metri. Invia al massimo uno tra resize_height, resize_longest_side e auto_size.

Usa invece la Resize API. La lunghezza a cui ridimensionare il lato più lungo della bounding box del modello, in metri. Invia al massimo uno tra resize_height, resize_longest_side e auto_size.

Usa invece la Resize API. Se stimare l'altezza reale dell'oggetto tramite visione artificiale e ridimensionare il modello di conseguenza. Invia al massimo uno tra resize_height, resize_longest_side e auto_size.

Usa invece la Resize API. Dove posizionare l'origine del modello, bottom o center. Il valore predefinito si applica quando invii resize_height, resize_longest_side o auto_size. Senza uno di questi, Meshy sposta l'origine solo se invii origin_at.

Usa invece la Convert API. Se convertire soltanto il modello in target_formats. Quando true, Meshy ignora topology, target_polycount, decimation_mode, resize_height, resize_longest_side e auto_size, ma ne controlla comunque i valori, quindi un valore non valido restituisce 400. Con convert_format_only: true, un target_formats vuoto o null restituisce 400.

Se generare anche un'anteprima con sfondo trasparente (RGBA), restituita in alpha_thumbnail_url quando recuperi il task. thumbnail_url non cambia.

La richiesta non può essere eseguita. Il messaggio di errore indica quale problema è stato rilevato. Ad esempio:

• Parametro mancante: Non è stato inviato né model_url né input_task_id.
• Task di input non valido: input_task_id non è un task API completato con successo, oppure il suo modello AI non supporta il remesh.
• Formato del modello non valido: Il file model_url ha un'estensione non supportata.
• URL non raggiungibile: Meshy non riesce a scaricare il file model_url.
• File del modello troppo grande: Il file model_url supera i 400 MB da un URL http o https, oppure supera i 100 MB come data URI.
• Troppe facce: Il file model_url supera i 100 MB e ha più di 10.000.000 di facce. Riduci il numero di facce, poi invia nuovamente il file.
• FBX ASCII oltre 100 MB: Il file model_url è un FBX ASCII che supera i 100 MB. Invialo come FBX binario o GLB.
• File del modello illeggibile: Il file model_url supera i 100 MB e Meshy non riesce a leggerne l'intestazione. Ad esempio, è un GLB o glTF compresso con Draco, oppure un FBX binario precedente alla versione 7.1.
• Intestazione del modello troppo complessa: Il file model_url supera i 100 MB e la sua intestazione ha troppe mesh, nodi o record da controllare. Riduci il numero di oggetti nel file, poi invialo nuovamente.
• Topologia non valida: topology non è quad né triangle.
• Parametri reciprocamente esclusivi: La richiesta contiene più di uno tra auto_size, resize_height e resize_longest_side. Inviane solo uno.

Correggi la richiesta, poi inviala di nuovo. Vedi Errori.

La chiave API è mancante o non valida. Controlla l'header Authorization.

Ad esempio:

• Crediti insufficienti: L'account non ha abbastanza crediti per questo task, oppure l'account ha raggiunto un limite di crediti. Controlla il tuo saldo crediti, poi riprova.
• Piano gratuito: Creare un task richiede un piano a pagamento. Aggiorna il tuo piano nelle impostazioni dell'abbonamento, poi riprova.

input_task_id è un modello a bassorilievo, che questo endpoint non può sottoporre a remesh. Il messaggio è This model type does not support this operation. Invia un modello diverso.

input_task_id non corrisponde a nessuno dei tuoi task. Controlla l'ID del task, poi invia di nuovo la richiesta.

Hai superato il tuo limite di frequenza. Attendi, poi riprova. Vedi Limiti di frequenza.

L'ID del task dalla risposta di creazione.

L'ID dell'attività da eliminare.

Il numero di pagina da restituire.

Il numero di task per pagina, fino a 100.

L'ordine di ordinamento.

Valori disponibili:

• +created_at: dal più vecchio al più recente
• -created_at: dal più recente al più vecchio

L'ID del task restituito dalla risposta di creazione.

L'ID del task. Trattalo come una stringa opaca e non fare affidamento sul suo formato.

Il tipo di task, sempre remesh.

URL di download per il modello remeshato, uno per ogni formato di file. Un formato non generato dal task non ha una chiave, invece di avere una stringa vuota.

URL di download per un'immagine di anteprima del modello remeshato.

URL di download per una versione di thumbnail_url con sfondo trasparente (RGBA). Presente solo quando hai creato il task con alpha_thumbnail: true e Meshy ha renderizzato l'anteprima trasparente.

Quanta parte del task è completata, in percentuale. È 0 finché il task non inizia e 100 quando ha successo.

Lo stato del task, uno tra PENDING, IN_PROGRESS, SUCCEEDED o FAILED.

Il numero di task davanti a questo nella coda. Il valore è significativo solo mentre il task è PENDING.

Ora di creazione del task, in millisecondi Unix.

Ora di avvio del task, in millisecondi Unix. È 0 finché il task non inizia.

Ora di completamento del task, in millisecondi Unix. È 0 finché il task non termina.

I dettagli dell'errore quando il task fallisce. Vedi Errori.

Il numero di crediti utilizzati dal task. Presente quando lo stato è PENDING, IN_PROGRESS o SUCCEEDED. È 0 per un task FAILED, perché Meshy rimborsa i crediti quando un task fallisce.