Text to 3D API

Questo campo deve essere impostato su "preview" quando si crea un task di anteprima.

Descrivi che tipo di oggetto è il modello 3D. Massimo 600 caratteri.

Specifica il tipo di generazione della mesh 3D.

Valori disponibili:

• standard: Generazione di mesh 3D regolare ad alto dettaglio.
• lowpoly: Genera mesh low-poly ottimizzate per poligoni più puliti.

ID del modello da utilizzare. Valori disponibili: meshy-5, meshy-6, latest (Meshy 6).

Controlla se abilitare la fase di remesh. Per la massima qualità del modello, si consiglia di impostare should_remesh su false.

Deprecato. Questo parametro non influisce più sull'output.

Il campo symmetry_mode controlla il comportamento della simmetria durante il processo di generazione del modello.

I valori validi sono:

• off: Disabilita la simmetria.
• auto: Determina e applica automaticamente la simmetria basata sulla geometria d'input.
• on: Impone la simmetria durante la generazione.

Specifica il pose mode per il modello generato.

Valori disponibili:

• a-pose: Generare il modello in posa A.
• t-pose: Generare il modello in posa T.
• "" (stringa vuota): Nessuna specifica posa applicata.

Usa pose_mode invece. Se generare il modello in posa A/T.

Non supportato da Meshy-6. Le richieste che utilizzano Meshy-6 ignoreranno art_style, e alcune combinazioni possono causare errori. Valori disponibili: realistic, sculpture.

Quando impostato su true, il contenuto d'ingresso sarà automaticamente controllato per contenuti potenzialmente dannosi. Se viene rilevato un contenuto dannoso, il task non procederà alla generazione.

Il testo da prompt sarà sottoposto a screening.

Specifica quali formati di file 3D includere nell'output. Solo i formati richiesti saranno generati e restituiti, il che può ridurre il tempo di completamento del task. Quando omesso, tutti i formati supportati sono inclusi.

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

Quando impostato su true, il task renderà anche una versione trasparente di sfondo (RGBA) dell'anteprima e la restituirà come alpha_thumbnail_url nella risposta GET. Il campo esistente thumbnail_url rimane invariato.

Quando impostato su true, il servizio utilizza la visione AI per stimare automaticamente l'altezza del mondo reale dell'oggetto e ridimensionare il modello di conseguenza. L'origine verrà impostata su bottom a meno che origin_at non sia esplicitamente impostato.

La richiesta non era accettabile. Cause comuni:

• Parametro mancante: Un parametro obbligatorio (es., prompt, mode) manca.
• Parametro non valido: art_style non è uno dei valori consentiti.
• Prompt troppo lungo: Il prompt supera il limite di caratteri.

Autenticazione fallita. Si prega di controllare la propria chiave API.

Crediti insufficienti per eseguire questo task.

Hai superato il tuo limite di frequenza.

Questo campo deve essere impostato su "refine" quando si crea un task di rifinitura.

L'ID del corrispondente task di anteprima.

Lo stato del task di anteprima fornito deve essere SUCCEEDED.

Genera mappe PBR (metallic, roughness, normal) oltre al colore base. Una mappa di emissione è inclusa quando ai_model è meshy-6 o latest, tranne per texture_resolution: 8k (non viene prodotta alcuna mappa di emissione).

Risoluzione della texture del colore base. Uno tra 2k (2048×2048), 4k (4096×4096) o 8k (8192×8192). Risoluzioni più alte catturano più dettagli di superficie. Si applica solo alla modalità refine.

Usa texture_resolution invece — equivalente a texture_resolution: "4k". Quando entrambi sono impostati, texture_resolution ha la precedenza.

Fornisci un prompt di testo aggiuntivo per guidare il processo di texturizzazione. Massimo 600 caratteri.

Fornisci un'immagine 2d per guidare il processo di texturizzazione. Attualmente supportiamo i formati .jpg, .jpeg, e .png.

Ci sono due modi per fornire l'immagine:

• URL accessibile pubblicamente: Un URL accessibile da Internet pubblico
• Data URI: Un Data URI codificato in base64 dell'immagine. Esempio di un Data URI: data:image/jpeg;base64,<your base64-encoded image data>

ID del modello da utilizzare per la rifinitura. Valori disponibili: meshy-5, meshy-6, latest (Meshy 6).

Quando impostato su true, il contenuto d'ingresso sarà automaticamente controllato per contenuti potenzialmente dannosi. Se viene rilevato un contenuto dannoso, il task non procederà alla generazione.

Sia il testo da texture_prompt che l'immagine da texture_image_url saranno sottoposti a screening.

Rimuove i riflessi e le ombre dalla texture del colore base, producendo un risultato più pulito che funziona meglio sotto configurazioni di illuminazione personalizzate.

Specifica quali formati di file 3D includere nell'output. Solo i formati richiesti saranno generati e restituiti, il che può ridurre il tempo di completamento del task. Quando omesso, tutti i formati supportati sono inclusi.

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

Quando impostato su true, il task renderà anche una versione trasparente di sfondo (RGBA) dell'anteprima e la restituirà come alpha_thumbnail_url nella risposta GET. Il campo esistente thumbnail_url rimane invariato.

Quando impostato su true, il servizio utilizza la visione AI per stimare automaticamente l'altezza del mondo reale dell'oggetto e ridimensionare il modello di conseguenza. L'origine verrà impostata su bottom a meno che origin_at non sia esplicitamente impostato.

La richiesta non era accettabile. Cause comuni:

• ID task non valido: Il preview_task_id è invalido o non esiste.
• Task non pronto: Il task di anteprima non ha ancora avuto successo.
• Incompatibilità modello: Il modello AI del task di anteprima è incompatibile con il modello di rifinitura richiesto.

Autenticazione fallita. Si prega di controllare la propria chiave API.

Crediti insufficienti per eseguire questo task.

Il task di anteprima specificato da preview_task_id non è stato trovato.

Hai superato il tuo limite di frequenza.

Identificatore univoco per il task Testo in 3D da ottenere.

L'ID del task Testo in 3D da eliminare.

Numero pagina per la paginazione.

Limite della dimensione della pagina. Il massimo consentito è 50 elementi.

Campo per ordinare.

Valori disponibili:

• +created_at: Ordina per tempo di creazione in ordine ascendente.
• -created_at: Ordina per tempo di creazione in ordine discendente.

Identificatore univoco per il task Testo in 3D da stream.

Identificatore univoco per il task. Sebbene utilizziamo un UUID ordinabile k per gli ID dei task come dettaglio di implementazione, non devi fare alcuna assunzione sul formato dell'ID.

Tipo di task Testo in 3D. I valori possibili sono text-to-3d-preview per i task di anteprima e text-to-3d-refine per i task di rifinitura.

URL scaricabile al 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.

Questo è il prompt non modificato che è stato utilizzato per creare il task.

Mantenuto per compatibilità retroattiva. Questo campo non ha alcun impatto funzionale sui modelli generati.

L'art_style non modificato che è stato utilizzato per creare il task di anteprima. Non supportato da Meshy-6.

Mantenuto per compatibilità retroattiva. Questo campo non ha alcun impatto funzionale sui modelli generati.

Prompt di testo aggiuntivo fornito per guidare il processo di texturizzazione durante la fase di rifinitura.

URL scaricabile all'immagine della texture che è stata utilizzata per guidare il processo di texturizzazione.

URL scaricabile all'immagine in miniatura del file del modello.

URL scaricabile a una versione trasparente di sfondo (RGBA) di thumbnail_url. Solo presente quando il task è stato creato con alpha_thumbnail: true e la miniatura trasparente è stata resa con successo; altrimenti questo campo è omesso.

URL scaricabile al video di anteprima. Sarà rimosso in una versione futura.

Progresso del task. Se il task non è ancora avviato, questa proprietà sarà 0. Una volta che il task è riuscito, diventerà 100.

Timestamp di quando il task è stato avviato, in millisecondi. Se il task non è ancora avviato, questa proprietà sarà 0.

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

Timestamp di quando il task è stato completato, in millisecondi. Se il task non è ancora completato, questa proprietà sarà 0.

Stato del task. I valori possibili sono uno tra PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Un array di oggetti URL delle texture che sono generati dal task. Di solito questo contiene solo uno oggetto URL delle texture. Ogni URL delle texture ha le seguenti proprietà:

Il conteggio dei task precedenti.

Dettagli sugli errori per i task falliti. Vedi Errori per il riferimento completo all'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).