01
hunyuan-3d/v3.1/pro/image-to-3d
Converti l'immagine di un oggetto frontale in una risorsa 3D con i controlli Pro per PBR, modalità geometria, conteggio dei volti personalizzato e immagini di visualizzazione extra opzionali.
hunyuan-3d/v3.1/pro/text-to-3d
Model:
L'API Hunyuan 3D v3.1 supporta la generazione Pro e Rapid di testo in 3D e di immagine in 3D per giochi, visualizzazione di prodotti, prototipazione e pipeline di risorse 3D.
Examples
Dettagli dei prezzi
Paghi solo ciò che usi. Nessun abbonamento, nessun costo nascosto.
| Fascia | Testo in 3D | Immagine in 3D |
|---|---|---|
| Pro | $0.300/gen 60 crediti/gen $0.375/genRisparmia il 20% | $0.300/gen 60 crediti/gen $0.375/genRisparmia il 20% |
| Rapid | $0.180/gen 36 crediti/gen $0.225/genRisparmia il 20% | $0.180/gen 36 crediti/gen $0.225/genRisparmia il 20% |
Costo di esempio (Rapid · Testo in 3D · Generazione base): 10 generazioni: $1.80
Extra
| Fascia | Prezzo PoYo | Originale / sconto |
|---|---|---|
| Pro · Immagine in 3D · Materiali PBR | +$0.120 24 crediti | +$0.150Risparmia il 20% Ufficiale |
| Pro · Immagine in 3D · Input multivista | +$0.120 24 crediti | +$0.150Risparmia il 20% Ufficiale |
| Pro · Testo in 3D · Numero di facce personalizzato | +$0.120 24 crediti | +$0.150Risparmia il 20% Ufficiale |
Come viene fatturato: Prezzo fisso per generazione. Gli extra sono fatturati in aggiunta al prezzo base.
Gli addebiti si basano sull'output finale.
Introduzione
Guida completa all'utilizzo di API Hunyuan 3D v3.1
API Hunyuan 3D v3.1
Hunyuan 3D v3.1 su PoYo.ai espone quattro modelli con invio di attività unificato, polling dello stato, supporto di callback e output 3D scaricabili al termine della generazione.
Modelli disponibili
Ottieni la chiave API
02
hunyuan-3d/v3.1/pro/text-to-3d
Inizia da un prompt di testo più lungo e utilizza le opzioni Pro come PBR, modalità geometria e conteggio dei volti personalizzato per una generazione di risorse più controllata.
03
hunyuan-3d/v3.1/rapid/text-to-3d
Genera bozze 3D rapide da prompt più brevi con determinazione rapida dei prezzi e PBR opzionale o controlli di output incentrati sulla geometria.
04
hunyuan-3d/v3.1/rapid/image-to-3d
Trasforma l'immagine di un singolo oggetto in un modello 3D utilizzando il modello di immagine Rapid a basso costo con impostazioni PBR o geometria opzionali.
Caratteristiche principali dell'API Hunyuan 3D v3.1
Scegli i modelli Pro o Rapid Hunyuan 3D v3.1 per la generazione di testo in 3D e di immagine in 3D con i controlli esposti di PoYo e l'accesso API asincrono.
01
Immagine Pro in 3D con guida alla vista
Carica l'immagine di un oggetto frontale e aggiungi viste opzionali laterali, posteriori, superiori, inferiori o angolate quando hai una maggiore copertura di riferimento. Il modello di immagine Pro può anche utilizzare PBR, modalità geometria e opzioni personalizzate di conteggio dei volti.
- Immagine frontale inviata come PoYo image_urls
- Campi immagine multivista opzionali per lavori di immagine Pro
- PBR e controlli personalizzati del conteggio dei volti quando necessario
02
Pro Text to 3D per prompt dettagliati
Utilizza Pro text-to-3D quando un brief di un oggetto scritto deve guidare la forma, la direzione del materiale e il concetto generale della risorsa. PoYo mantiene il flusso API asincrono in modo che il polling dello stato e i callback funzionino come gli altri modelli 3D.
- Richiedi input fino al limite del modello Pro
- PBR opzionale, modalità geometria e conteggio dei volti
- Stato unificato e recupero dei file
03
Testo rapido in 3D per bozze più veloci
La conversione rapida del testo in 3D è utile per l'ideazione iniziale, l'esplorazione degli oggetti e le bozze delle risorse a basso costo. Usalo quando sono sufficienti brevi prompt e il team ha bisogno di confronti rapidi prima di selezionare una direzione finale.
- Costo del credito base inferiore rispetto a Pro
- PBR opzionale quando la modalità geometria non è selezionata
- Adatto per l'esplorazione e l'iterazione delle risorse
04
Immagine rapida in 3D da un unico riferimento
Utilizza il modello di immagine Rapid quando disponi già di un prodotto, di un oggetto di scena, di uno schizzo o di un riferimento a un oggetto e desideri un risultato 3D rapido. PoYo accetta un semplice input image_urls e restituisce risultati di attività normalizzati.
- Una fonte di immagini per il modello Rapid
- Opzioni PBR o geometria dove supportate
- Miniature restituite e file di modello normalizzati da PoYo
Casi d'uso
01
Ideazione degli oggetti di gioco
Genera i primi concetti degli oggetti di scena da prompt o riferimenti a oggetti prima di dedicare tempo alla modellazione manuale.
02
Visualizzazione di prodotti e oggetti
Trasforma i riferimenti con vista frontale o multivista in output 3D per la revisione, la prototipazione e le pipeline delle risorse downstream.
03
Esplorazione batch di risorse 3D
Confronta i risultati Pro e Rapid in un unico formato API mantenendo coerenti prezzi, stato delle attività e recupero dei file.
04
Pipeline 3D asincrone
Invia lavori 3D Hunyuan con callback o polling e instrada i file di modello completati negli strumenti di produzione.
Hunyuan 3D v3.1 Pro vs Rapido
Confronto di alto livello dei quattro modelli Hunyuan 3D v3.1 esposti su PoYo.
| Funzionalità | Pro | Rapido |
|---|---|---|
| Modelli di input | Testo in 3D e immagine in 3D | Testo in 3D e immagine in 3D |
| Migliore adattamento | Lavori ad alto controllo che richiedono PBR, modalità geometria, conteggio dei volti o guida multivista | Bozze a costi inferiori e iterazione più rapida dai prompt o da un'immagine |
| Lunghezza prompt | Fino a 1024 caratteri | Fino a 200 caratteri |
| Controlli immagine | Immagine frontale più URL di visualizzazione aggiuntivi facoltativi sui lavori di immagine Pro | Ingresso immagine frontale singolo |
| Modello di prezzo | 60 crediti base, con costi aggiuntivi facoltativi | 36 crediti base, con componente aggiuntivo PBR opzionale |
Gli output esatti disponibili dipendono dal modello selezionato e dai file restituiti.
Come utilizzare l'API Hunyuan 3D v3.1 su PoYo
Passaggio 1: crea una chiave API
Registrati su PoYo e crea una chiave API dalla tua dashboard.
Crea chiave API ->
Passaggio 2: scegli un modello Hunyuan 3D v3.1
Seleziona uno dei quattro ID modello pubblici: immagine Pro, testo Pro, testo Rapid o immagine Rapid.
Passaggio 3: invia input PoYo
Utilizza prompt per modelli di testo o image_urls per i modelli di immagine. Aggiungi campi PBR, geometria, conteggio dei volti o campi multivista solo quando il modello selezionato li supporta.
Passaggio 4: recupera le risorse generate
Esegui il polling dell'endpoint dello stato dell'attività o fornisci un URL di callback, quindi scarica i file GLB, OBJ, MTL, texture, miniatura o URL del modello restituiti quando disponibili.
Visualizza documentazione ->
Prezzi API Hunyuan 3D v3.1
Hunyuan 3D v3.1 su PoYo utilizza prezzi per generazione con costi aggiuntivi opzionali.
I modelli Pro partono da 60 crediti ($0.30) per generazione. I modelli rapidi partono da 36 crediti ($0.18) per generazione.
I componenti aggiuntivi supportati costano 24 crediti ($0.12) ciascuno. I componenti aggiuntivi includono PBR quando applicabile, input multi-vista sui lavori di immagine Pro e conteggio dei volti personalizzato sui lavori Pro.
Aggiungi crediti e inizia a testare Hunyuan 3D v3.1 su PoYo. Ricarica crediti ->
Domande frequenti
Quale modello Hunyuan 3D v3.1 dovrei scegliere?
Utilizza Pro quando hai bisogno di controlli aggiuntivi come PBR, modalità geometria, conteggio dei volti personalizzato o guida alle immagini multivista. Utilizza Rapid per realizzare bozze a basso costo da testo o da un'immagine.
Come funzionano gli input di immagini su PoYo?
Invia modelli di immagine con image_urls contenenti un URL dell'immagine frontale. PoYo mantiene coerente il formato di input rivolto all'utente tra i modelli di immagini 3D di Hunyuan.
Posso utilizzare immagini multivista?
Sì, ma solo con hunyuan-3d/v3.1/pro/image-to-3d. I campi di visualizzazione facoltativi includono gli URL delle immagini posteriore, sinistra, destra, superiore, inferiore, anteriore sinistra e anteriore destra.
Quali file può restituire l'API?
I risultati possono includere GLB, OBJ, MTL, file di texture, miniature e raccolte di URL di modelli a seconda del modello Hunyuan 3D v3.1 selezionato.
Perché utilizzare PoYo.ai
01
Un'API 3D asincrona
Utilizza lo stesso modello di invio, stato, callback e recupero file su tutti e quattro i modelli Hunyuan 3D v3.1.
02
Prezzi del credito trasparenti
Visualizza chiaramente i crediti per la generazione di base e i costi aggiuntivi prima di inviare un lavoro.
03
Controlli specifici del modello
Il parco giochi presenta solo i controlli supportati dal modello Pro o Rapid selezionato.
04
File di output normalizzati
PoYo raccoglie i file di modello, texture e miniatura restituiti in un formato coerente di risultati dell'attività.