API Testo in 3D

Questo campo deve essere impostato su "preview" quando si crea un'attività di anteprima.

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

Specifica il tipo di generazione della mesh 3D.

Valori disponibili:

• standard: generazione regolare di mesh 3D ad alto dettaglio.
• smart-topology: scegli il modello Smart Topology con ai_model (meshy-t2).
• lowpoly (deprecato): genera una mesh low-poly ottimizzata per poligoni più puliti. Consigliamo di usare invece smart-topology.

ID del modello da utilizzare. I valori disponibili dipendono da model_type.

Generazione standard (model_type: standard):

• meshy-5, meshy-6, meshy-7, latest (Meshy 7)

Generazione Smart Topology (model_type: smart-topology):

• meshy-t2 (predefinito): il modello Smart Topology — topology più pulita, parti separate nativamente, output in triangoli e un numero di facce impostabile con target_polycount.

Abilita la generazione Ultra per una geometria di qualità superiore con dettagli di superficie più fini. La generazione richiede più tempo e aggiunge 5 crediti.

Controlla se abilitare la fase di remesh. Per il modello di qualità più elevata, consigliamo di impostare should_remesh su false.

Numero target di poligoni (facce) nell'output. Il conteggio effettivo può discostarsi dal target a seconda della geometria.

target_polycount ha effetto in due casi indipendenti:

• Remesh — con should_remesh: true su un modello standard. La mesh viene sottoposta a remesh (decimata) fino a raggiungere approssimativamente questo conteggio. Intervallo da 100 a 300.000, predefinito 30.000. Se decimation_mode è impostato, ha la priorità e target_polycount viene ignorato.
• Smart Topology — con model_type: smart-topology e ai_model: meshy-t2. Il modello viene generato direttamente con questo conteggio di facce; non viene eseguito alcun remesh e should_remesh non è richiesto. Intervallo da 100 a 15.000, predefinito 4.000.

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

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

I valori validi sono:

• off: disabilita la simmetria.
• auto: determina e applica automaticamente la simmetria in base alla geometria di input.
• on: impone la simmetria durante la generazione.

Specifica il pose_mode per il modello generato.

Valori disponibili:

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

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

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

Quando impostato su true, il contenuto di input verrà automaticamente esaminato per individuare eventuali contenuti potenzialmente dannosi. Se viene rilevato contenuto dannoso, l'attività non procederà alla generazione.

Il testo di prompt verrà esaminato.

Specifica quali formati di file 3D includere nell'output. Verranno generati e restituiti solo i formati richiesti, il che può ridurre il tempo di completamento dell'attività. Se omesso, vengono inclusi tutti i formati supportati.

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

Quando impostato su true, l'attività genera in aggiunta una versione con sfondo trasparente (RGBA) dell'anteprima e la restituisce come alpha_thumbnail_url nella risposta GET. Il campo thumbnail_url esistente rimane invariato.

Quando impostato su true, il servizio utilizza la visione artificiale per stimare automaticamente l'altezza reale dell'oggetto e ridimensionare il modello di conseguenza. L'origine sarà impostata su bottom per impostazione predefinita, a meno che origin_at non venga impostato esplicitamente.

La richiesta non è stata accettata. Cause comuni:

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

Autenticazione fallita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questa attività.

Hai superato il tuo limite di frequenza.

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

L'id del task di preview corrispondente.

Lo stato del task di preview specificato deve essere SUCCEEDED.

Genera mappe PBR (metallic, roughness, normal) oltre al colore base. Viene incluso anche un emission map quando ai_model è meshy-6, eccetto con texture_resolution: 8k (in questo caso non viene prodotto alcun emission map). meshy-7 (e latest) non produce un emission map.

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

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

Fornisce un prompt testuale aggiuntivo per guidare il processo di texturing. Massimo 800 caratteri.

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

Esistono due modi per fornire l'immagine:

• URL pubblicamente accessibile: un URL accessibile da internet pubblicamente
• Data URI: un data URI dell'immagine codificato in base64. Esempio di data URI: data:image/jpeg;base64,<i tuoi dati immagine codificati in base64>

ID del modello da usare per il refine. Valori disponibili: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

Quando impostato su true, il contenuto in input verrà automaticamente controllato per individuare eventuali contenuti potenzialmente dannosi. Se viene rilevato contenuto dannoso, il task non procederà con la generazione.

Verranno controllati sia il testo di texture_prompt che l'immagine di texture_image_url.

Rimuove luci e ombre dalla texture del colore base, producendo un risultato più uniforme che funziona meglio con configurazioni di illuminazione personalizzate.

Specifica quali formati di file 3D includere nell'output. Verranno generati e restituiti solo i formati richiesti, il che può ridurre il tempo di completamento del task. Se omesso, vengono inclusi tutti i formati supportati.

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

Quando impostato su true, il task genera inoltre una versione con sfondo trasparente (RGBA) della preview e la restituisce come alpha_thumbnail_url nella risposta GET. Il campo thumbnail_url esistente rimane invariato.

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

La richiesta non è stata accettata. Cause comuni:

• ID task non valido: il preview_task_id non è valido o non esiste.
• Task non pronto: il task di preview non è ancora andato a buon fine.
• Modello non corrispondente: il modello AI del task di preview non è compatibile con il modello di refine richiesto.

Autenticazione non riuscita. Controlla la tua chiave API.

Crediti insufficienti per eseguire questo task.

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

Hai superato il limite di frequenza.

Identificatore univoco per l'attività di Testo in 3D da recuperare.

L'ID dell'attività di Testo in 3D da eliminare.

Numero di pagina per la paginazione.

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

Campo per l'ordinamento.

Valori disponibili:

• +created_at: Ordina per tempo di creazione in ordine crescente.
• -created_at: Ordina per tempo di creazione in ordine decrescente.

Identificatore univoco per l'attività di Testo in 3D da trasmettere.

Identificatore univoco per il task. Anche se utilizziamo un UUID ordinabile per k per gli id dei task come dettaglio di implementazione, non dovresti fare alcuna ipotesi 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 raffinamento.

URL scaricabile per il 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.

Lo 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 raffinamento.

Rispecchia il valore ultra_mode con cui è stato creato il task di anteprima. Presente solo per i task di anteprima meshy-7 (o latest) che hanno esplicitamente impostato ultra_mode; altrimenti omesso.

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

URL scaricabile per l'immagine in miniatura del file del modello.

URL scaricabile per una versione a 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 è omesso.

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

Progresso del task. Se il task non è ancora iniziato, 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 iniziato, 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 di PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

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

Il conteggio dei task precedenti.

Dettagli dell'errore 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).