Da immagine a 3DInformazioni su Seed3D 2.0
Modelli 3D con texture ricche da un’immagine, ottimo per i personaggi.
Lo chiami con il nome di modello bytedance/seed3d-2.0/image-to-3d su POST /jobs/createTask, da 0,48 USD.
Introduzione
Seed3D 2.0 è il modello di asset 3D del team Seed di ByteDance, rilasciato ad aprile 2026. Legge una singola immagine e costruisce l'oggetto che vi appare come una mesh 3D completa con materiali, così uno scatto di prodotto o il render di un personaggio diventa qualcosa che puoi ruotare, illuminare e collocare in una scena. La richiesta accetta un'immagine (image_url) e un interruttore facoltativo della densità (mesh_detail); non ci sono campi per prompt, seed o stile. Il risultato è un file glTF binario (.glb) con le texture incluse al suo interno.
Caratteristiche principali
Geometria e materiali da una sola immagine
Seed3D 2.0 genera insieme la forma e un materiale basato sulla fisica. Nelle nostre prove ogni modello è tornato con due texture 4096×4096, una mappa del colore di base e una mappa metal-roughness, quindi la pelle appariva consumata e opaca, mentre gli occhielli in ottone e la visiera di un casco riflettevano la luce. Non c'è una mappa delle normali separata: il dettaglio della superficie è nella mesh stessa.
Una mesh densa e chiusa
Al livello predefinito medium, i due modelli di test sono tornati con una mesh e un materiale, poco sotto i 500.000 triangoli; con low lo stesso stivale aveva 99.977 facce. Secondo chi l'ha pubblicato, i livelli corrispondono a circa 100.000, 500.000 e 1.000.000 di facce. Una mesh più densa conserva meglio dettagli piccoli come lacci, cuciture e dita; una più leggera si carica più in fretta nel browser.
Cosa abbiamo misurato
Abbiamo inviato una foto da studio 1024×1024 di uno stivale di pelle e un render 682×1024 di un astronauta giocattolo. Entrambi hanno restituito file GLB validi: 37,2 MB e 28,6 MB, 499.998 e 499.992 triangoli, elaborati in 356 e 340 secondi. L'astronauta ha mantenuto volto, visiera, pannello del petto e rifiniture arancioni su tutti i lati. Lo stivale, inviato in vista frontale diritta, è tornato con la metà posteriore specchiata dalla parte anteriore.
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
image_url | Sì | L'immagine di partenza. |
mesh_detail | No | Densità della mesh: low (circa 100.000 facce), medium (circa 500.000) o high (circa 1.000.000). Tutte e tre costano uguale; i livelli più alti mantengono più dettagli e producono file più grandi. low · medium · high · Predefinito: medium |
Prezzi
I prezzi sono in USD. L’API usa un saldo separato in dollari statunitensi. I crediti del sito non si possono usare per l’API né convertire in saldo API; il saldo API non si può convertire in crediti del sito. Quando una richiesta viene accettata, riserviamo l’importo massimo del preventivo sul tuo saldo API. Al termine addebitiamo l’uso effettivo, senza superare la riserva, e liberiamo il resto. Se la richiesta fallisce, l’importo riservato viene sbloccato.
| Opzione | USD per generazione |
|---|---|
| Standard | 0,48 USD |
Prima di eseguire, invia lo stesso corpo della richiesta a POST /jobs/quote per vedere il costo stimato e quello massimo in USD. Il preventivo non esegue alcuna richiesta né addebita il saldo.
Casi d'uso
E-commerce e visualizzatori di prodotto
Uno scatto packshot diventa un modello interattivo per la pagina prodotto o un'anteprima AR. Fotografa o renderizza il prodotto da un'angolazione a tre quarti su sfondo uniforme, tieni l'oggetto intero nell'inquadratura e usa il livello medium per un buon equilibrio tra dettaglio e dimensione del download.
Personaggi, giocattoli e oggetti da collezione
I render di personaggi e le foto di statuine si convertono bene perché le forme sono semplici e i colori decisi. La texture porta dettagli dipinti come volti, badge e strisce; il retro viene dedotto, quindi scegli una posa in cui si vede la maggior parte del personaggio.
Guida ai prompt e consigli da esperti
Prepara l'immagine
Un solo soggetto, centrato, con un po' di margine intorno e nulla che tocchi il bordo dell'inquadratura. Uno sfondo chiaro e uniforme separa bene l'oggetto. Sono accettati JPEG, PNG o WebP fino a 10 MB, e le proporzioni dell'immagine devono restare tra circa 2:5 e 5:2.
Scegli l'angolazione di proposito
Il modello vede solo un lato. Una vista frontale diritta di una scarpa o di un'auto lascia ignota la lunghezza dell'oggetto, e la metà nascosta può essere completata come specchio del davanti. Una vista a tre quarti che mostri davanti e un fianco dà un risultato molto più affidabile.
Scegli il livello di dettaglio in base all'uso
Usa low per le anteprime mobili e le scene con molti oggetti di scena, medium per la maggior parte dei visualizzatori web e high quando il modello verrà esaminato da vicino o stampato in 3D.
Controlla il risultato prima di pubblicarlo
Apri il GLB in un visualizzatore, ruotalo completamente e guarda il lato che non hai mostrato. Se il retro sembra sbagliato, prova un'altra foto con un'angolazione diversa invece di un altro livello di dettaglio.
Guida rapida all'API
Chiama l'API di Seed3D 2.0 in tre passaggi
- Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow-. Le chiamate usano il tuo saldo separato in dollari statunitensi.
- Invia la richiesta. Invia POST /jobs/createTask con model bytedance/seed3d-2.0/image-to-3d e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seed3d-2.0/image-to-3d",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"mesh_detail": "medium"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.
Domande sull’API di Seed3D 2.0
Quanto costa l’API di Seed3D 2.0?
Seed3D 2.0 costa 0,48 USD per generazione. L’API usa un saldo separato in dollari statunitensi. I crediti del sito non si possono usare per l’API né convertire in saldo API; il saldo API non si può convertire in crediti del sito. Quando una richiesta viene accettata, riserviamo l’importo massimo del preventivo sul tuo saldo API. Al termine addebitiamo l’uso effettivo, senza superare la riserva, e liberiamo il resto. Se la richiesta fallisce, l’importo riservato viene sbloccato.
Qual è il nome del modello di Seed3D 2.0 nell’API?
Inserisci bytedance/seed3d-2.0/image-to-3d per Da immagine a 3D nel campo model di POST /jobs/createTask.
Cosa ricevo?
Un file .glb (glTF 2.0 binario) con le texture incorporate: una mappa di colore base e una di metallo-rugosità, entrambe PNG 4096×4096 nelle nostre prove. Blender, three.js, model-viewer, Unity e Unreal lo importano direttamente.
Serve un prompt?
No. L’unico input obbligatorio è l’immagine. mesh_detail è facoltativo e cambia solo la densità della mesh.
Quale immagine funziona meglio?
Un solo soggetto, interamente nell’inquadratura, su sfondo uniforme, visto di tre quarti. Scene affollate, oggetti tagliati e viste frontali costringono il modello a indovinare ciò che non vede.
Quali sono i limiti dell’API di Seed3D 2.0?
Caricamento massimo: 10 MB. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare Seed3D 2.0 senza scrivere codice?
Esegui Seed3D 2.0 nel Playground con il tuo saldo API in USD, senza chiave API. Ogni esecuzione compare nella cronologia sviluppatore con il codice corrispondente.