Retexture API

Obbligatorio a meno che tu non invii model_url. L'ID di un task che ha generato un modello 3D da texturizzare, ad esempio un task di Testo in 3D, Immagine in 3D, Remesh o Retexture. Il task deve essere uno che hai creato con l'API e deve avere lo stato SUCCEEDED. Meshy applica la texture al GLB del task.

Obbligatorio a meno che tu non invii input_task_id. Il modello da texturizzare, 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 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, ad esempio data:application/octet-stream;base64,<i tuoi dati del modello codificati in base64>.

Un file oltre 100 MB deve anche 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 quadrilatero 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 utilizzare la compressione Draco.

Obbligatorio a meno che tu non invii image_style_url o multiview_image_urls. Testo che descrive la texture desiderata, fino a 800 caratteri. Un testo più lungo restituisce 400.

Obbligatorio a meno che tu non invii text_style_prompt o multiview_image_urls. Un'immagine 2D il cui stile la texture segue, come URL pubblico o data URI (data:image/jpeg;base64,<i tuoi dati immagine codificati in base64>). Se invii sia text_style_prompt che image_style_url, Meshy usa image_style_url.

L'immagine deve essere un file .jpg, .jpeg, .png o .webp di massimo 20 MB.

La texture potrebbe non adattarsi bene quando l'oggetto nell'immagine ha una forma molto diversa da quella del modello.

Obbligatorio a meno che tu non invii text_style_prompt o image_style_url. Da una a quattro immagini dello stesso oggetto da viste diverse. La prima immagine è la vista principale (frontale). L'ordine delle altre viste (sinistra, retro, destra) non è rilevante. Un array vuoto, o più di quattro immagini, restituisce 400.

Ogni immagine segue le stesse regole di formato e dimensione di image_style_url, al massimo 20 MB per immagine. Non puoi combinare multiview_image_urls con text_style_prompt o image_style_url.

multiview_image_urls richiede un "ai_model": "meshy-7" esplicito. Qualsiasi altro ai_model, incluso il predefinito latest, restituisce 400.

Il modello AI che genera la texture.

Valori disponibili:

• meshy-6-lite
• meshy-6
• meshy-7
• latest: Meshy 7

Se mantenere il layout UV del modello invece di generarne uno nuovo.

• Per un modello generato da Meshy, da input_task_id o un model_url che punta a un output di Meshy, usa true per riutilizzare il suo layout UV ottimizzato.
• Per un modello caricato da altrove, usa true per mantenere UV già di buona qualità. Lascialo false per permettere a Meshy di generare nuovi UV, cosa adatta a un modello senza una corretta mappatura UV.

Se generare anche le mappe PBR (metallic, roughness e normal) insieme al colore base. Con meshy-6, Meshy genera anche una mappa di emissione, eccetto a una texture_resolution di 8k. meshy-6-lite, meshy-7 e latest non generano una mappa di emissione.

La dimensione della texture del colore base. Risoluzioni più alte catturano più dettagli di superficie.

Valori disponibili:

• 2k: 2048 × 2048 pixel
• 4k: 4096 × 4096 pixel
• 8k: 8192 × 8192 pixel

4k e 8k richiedono un ai_model pari a meshy-6, meshy-7 o latest. Con meshy-6-lite, restituiscono 400. A 8k, Meshy non genera una mappa di emissione.

Usa texture_resolution invece. true equivale a texture_resolution: "4k". Se invii entrambi, Meshy usa texture_resolution.

Se rimuovere luci e ombre dalla texture del colore base. Il risultato funziona meglio con la tua illuminazione personale.

Meshy lo applica solo con meshy-6, a una texture_resolution di 2k o 4k. Con meshy-7 o latest, oppure a 8k, Meshy lo accetta e lo ignora. Con meshy-6-lite, inviarlo con qualsiasi valore restituisce 400.

I formati di file da generare. Meshy genera solo i formati elencati, il che può ridurre la durata del task. Se lo ometti, Meshy genera tutti i formati tranne 3mf.

Valori disponibili:

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

Se renderizzare 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.
• Stile mancante: Non è stato inviato nessuno tra text_style_prompt, image_style_url e multiview_image_urls.
• Input di stile in conflitto: multiview_image_urls è stato inviato insieme a text_style_prompt o image_style_url.
• Modello non supportato per multi-vista: multiview_image_urls è stato inviato senza un "ai_model": "meshy-7" esplicito.
• Task di input non valido: input_task_id non è un task riuscito di un tipo supportato.
• Formato modello non valido: Il file model_url ha un'estensione non supportata.
• URL non raggiungibile: Meshy non riesce a scaricare il file model_url, l'immagine image_style_url, o un'immagine di multiview_image_urls.
• File del modello troppo grande: Il file model_url supera i 400 MB da un URL http o https, oppure 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 oltre 100 MB. Inviarlo come FBX binario o GLB.
• File del modello illeggibile: Il file model_url supera i 100 MB e Meshy non riesce a leggerne l'header. Ad esempio, è un GLB o glTF compresso con Draco, oppure un FBX binario precedente alla versione 7.1.
• Header del modello troppo complesso: Il file model_url supera i 100 MB e il suo header ha troppe mesh, nodi o record da controllare. Riduci il numero di oggetti nel file, poi invialo di nuovo.
• Immagine troppo grande: L'immagine image_style_url o un'immagine di multiview_image_urls supera i 20 MB.

Correggi la richiesta, poi invia nuovamente. Consulta 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: La creazione di un task richiede un piano a pagamento. Aggiorna il tuo piano nelle impostazioni dell'abbonamento, poi riprova.

input_task_id è un modello bassorilievo, che questo endpoint non può retexturizzare. 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 nuovamente la richiesta.

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

L'ID dell'attività dalla risposta di creazione.

L'ID del task 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
• -created_at: dal più recente

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

URL di download per il modello 3D con texture, uno per ogni formato di file.

Il prompt testuale con cui hai creato il task.

L'immagine di stile con cui hai creato il task.

URL di download per le immagini di riferimento multi-vista con cui hai creato il task. Presente solo quando hai creato il task con multiview_image_urls.

URL di download per un'immagine in miniatura del modello.

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.

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

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

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

Momento in cui i risultati del task scadono, in millisecondi Unix.

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

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

URL di download per le texture generate, come array di oggetti. L'array di solito contiene un solo oggetto. Ogni oggetto ha questi campi:

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

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.