API Rilievo

La foto da trasformare in rilievo, come URL pubblico o Data URI (data:image/png;base64,...).

L'immagine deve essere un file JPG, JPEG, PNG o WebP di al massimo 20 MB e almeno 32 × 32 pixel. Il lato più lungo può essere al massimo circa 16 volte il lato più corto. Qualsiasi altra immagine restituisce 400. Meshy riempie le aree trasparenti con il nero prima di costruire il rilievo.

Lo stile del rilievo. Definisce la mappa di profondità e imposta il valore predefinito di carving_depth_mm.

Valori disponibili:

• high: incisione più profonda, per pezzi stampati in 3D.
• low: incisione poco profonda, per incisione laser, lavorazione CNC e targhe sottili.

Inviare null o "" equivale a ometterlo. Qualsiasi altro valore restituisce 400.

Se costruire il modello del rilievo. Impostalo su false per un task che produce solo la mappa di profondità, senza modello e senza immagine di anteprima. Meshy controlla comunque i parametri di dimensione, incisione, base, piegatura e risoluzione, ma non li utilizza. Non modifica il costo in crediti.

La lunghezza del lato più lungo della foto sul modello, misurata piatta prima di qualsiasi piegatura, da 20 a 250 millimetri. Con remove_base, il modello può essere più piccolo.

Se il soggetto risalta dalla lastra o viene inciso al suo interno.

Valori disponibili:

• emboss: le parti più vicine della foto risaltano.
• engrave: la profondità è invertita, quindi le parti più vicine vengono incise all'interno.

La mappa di profondità è la stessa in entrambe le modalità.

Quanto è profondo il rilievo inciso, da 0 a 60 millimetri. Con remove_base impostato su true, 0 lascia un modello vuoto. Il task comunque riesce e costa 20 crediti, e i suoi file GLB e STL non hanno geometria.

Se ritagliare lo sfondo e non costruire alcuna lastra di base. Quando è true, removal_threshold definisce cosa conta come sfondo. Meshy controlla removal_threshold in entrambi i casi.

Lo spessore della lastra di base, da 0.1 a 10 millimetri. Quando remove_base è true, ometti il parametro o invia 0.

Se piegare il rilievo, e in quale direzione. Quando non è off, bend_axis e bend_angle definiscono la piegatura. Meshy li controlla in entrambi i casi.

Valori disponibili:

• off: un rilievo piatto.
• convex: la parte frontale si gonfia verso l'esterno.
• concave: la parte frontale si curva verso l'interno.

Il numero di punti della mesh lungo il lato più lungo della foto, da 512 a 2048. Un valore più alto mantiene dettagli più fini e produce file più grandi. Al valore predefinito 1024, il file GLB è di circa 40-50 MB e il file STL di circa 80-105 MB. Una foto quadrata produce le dimensioni maggiori. A 2048, sono circa 150 MB e 300 MB. Una piegatura li rende più grandi: il file STL può raggiungere circa 800 MB a 2048.

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

• Parametro mancante: image_url non è stato inviato.
• Parametro non valido: Un parametro ha il tipo sbagliato, è fuori dal suo intervallo, o non è uno dei suoi valori disponibili. Ad esempio, variant non è high o low, oppure mesh_resolution non è un intero da 512 a 2048.
• Spessore della base: base_thickness_mm non è 0 con remove_base impostato su true, oppure è inferiore a 0.1 senza di esso.
• URL non raggiungibile: Meshy non riesce a scaricare l'immagine da image_url, ad esempio perché l'URL restituisce 404 o va in timeout.
• Immagine non valida: L'immagine non è un file JPG, JPEG, PNG o WebP, supera i 20 MB, è più piccola di 32 × 32 pixel, ha troppi pixel, o non può essere letta.
• Proporzioni estreme: Il lato più lungo dell'immagine è più di circa 16 volte il lato più corto.

Correggi la richiesta, quindi inviala di nuovo. Meshy non addebita crediti per questo. Vedi Errori.

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

Ad esempio:

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

La moderation dei contenuti ha bloccato l'immagine. Meshy non addebita crediti per la richiesta. Invia un'immagine diversa.

È stato raggiunto uno di questi limiti:

• Hai inviato troppe richieste. Attendi, quindi riprova. Vedi Limiti di frequenza.
• Troppi tuoi task sono in coda o in esecuzione. Attendi che alcuni terminino, quindi riprova.
• Su un piano illimitato senza crediti residui, hai raggiunto il numero di task che possono essere eseguiti senza crediti. Attendi che un task finisca, oppure aggiungi crediti.

L'ID del task dalla risposta di creazione.

L'ID dell'attività da eliminare.

Il numero di pagina da restituire. Inizia da e ha come valore predefinito 1.

Il numero di task per pagina, fino a 100. Il valore predefinito è 10. Meshy tratta un valore compreso tra 101 e 255 come 100, mentre un valore maggiore restituisce 400.

L'ordine di ordinamento.

Valori disponibili:

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

L'ID del task 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 relief.

URL di download per il modello del rilievo. I file possono essere di grandi dimensioni; mesh_resolution elenca le dimensioni tipiche.

URL di download per la depth map in scala di grigi a 16 bit da cui è costruito il rilievo. I pixel più chiari sono più alti. I valori sono altezze relative, non millimetri. I software di incisione laser e CNC possono usarla come height map. Il file è di circa 1-2 MB. Vuoto se non ce n'è nessuna.

URL di download per un'immagine di anteprima del modello del rilievo. Vuoto se non è stata renderizzata alcuna anteprima, anche per un task solo depth-map.

Quanto del task è completato, in percentuale. È 0 finché il task non inizia e 100 quando ha esito positivo.

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

Il numero di task che precedono questo nella coda. Il campo viene omesso quando il valore è 0, quindi appare solo finché ci sono task davanti a questo.

Momento in cui il task è stato creato, in millisecondi Unix.

Momento in cui il task è iniziato, in millisecondi Unix. È 0 finché il task non inizia.

Momento in cui il task è terminato, in millisecondi Unix. È 0 finché il task non termina.

Momento in cui il risultato del task scade, 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: 20, oppure 0 per un task FAILED, che Meshy rimborsa.