01
hunyuan-3d/v3.1/pro/image-to-3d
Zet een afbeelding van de voorkant van een object om in een 3D-asset, met Pro-instellingen voor PBR, geometriemodus, een eigen aantal vlakken en optionele extra aanzichten.
hunyuan-3d/v3.1/pro/text-to-3d
Model:
De Hunyuan 3D v3.1 API ondersteunt Pro- en Rapid-generatie van tekst naar 3D en afbeelding naar 3D voor games, productvisualisatie, prototyping en 3D-asset-pipelines.
Examples
Prijsdetails
Betaal naar gebruik. Geen abonnement, geen verborgen kosten.
| Niveau | Tekst naar 3D | Afbeelding naar 3D |
|---|---|---|
| Pro | $0.300/gen. 60 credits/gen. $0.375/gen.Bespaar 20% | $0.300/gen. 60 credits/gen. $0.375/gen.Bespaar 20% |
| Rapid | $0.180/gen. 36 credits/gen. $0.225/gen.Bespaar 20% | $0.180/gen. 36 credits/gen. $0.225/gen.Bespaar 20% |
Voorbeeldkosten (Rapid · Tekst naar 3D · Basisgeneratie): 10 generaties: $1.80
Add-ons
| Niveau | PoYo-prijs | Origineel / korting |
|---|---|---|
| Pro · Afbeelding naar 3D · PBR-materialen | +$0.120 24 credits | +$0.150Bespaar 20% Officieel |
| Pro · Afbeelding naar 3D · Invoer met meerdere beelden | +$0.120 24 credits | +$0.150Bespaar 20% Officieel |
| Pro · Tekst naar 3D · Eigen aantal vlakken | +$0.120 24 credits | +$0.150Bespaar 20% Officieel |
Zo wordt er gefactureerd: Vaste prijs per generatie. Add-ons worden bovenop de basisprijs gefactureerd.
De kosten zijn gebaseerd op de uiteindelijke output.
Introductie
Complete gids voor het gebruik van Hunyuan 3D v3.1 API
Hunyuan 3D v3.1 API
Hunyuan 3D v3.1 op PoYo.ai biedt vier modellen met uniforme taakinzending, statuspolling, callback-ondersteuning en downloadbare 3D-uitvoer zodra de generatie klaar is.
Beschikbare modellen
API-sleutel ophalen
02
hunyuan-3d/v3.1/pro/text-to-3d
Begin met een langere tekstprompt en gebruik Pro-opties zoals PBR, geometriemodus en een eigen aantal vlakken voor beter gestuurde assetgeneratie.
03
hunyuan-3d/v3.1/rapid/text-to-3d
Genereer snel 3D-concepten uit kortere prompts tegen Rapid-prijzen, met optionele instellingen voor PBR of uitvoer gericht op geometrie.
04
hunyuan-3d/v3.1/rapid/image-to-3d
Maak van één afbeelding van een object een 3D-model met het goedkopere Rapid-afbeeldingsmodel, met optionele PBR- of geometrie-instellingen.
Belangrijkste functies van de Hunyuan 3D v3.1 API
Kies de Pro- of Rapid-modellen van Hunyuan 3D v3.1 voor generatie van tekst naar 3D en afbeelding naar 3D, met de instellingen die PoYo aanbiedt en toegang via een asynchrone API.
01
Pro afbeelding naar 3D met sturing via aanzichten
Upload één afbeelding van de voorkant van een object en voeg optioneel zij-, achter-, boven-, onder- of schuine aanzichten toe als je meer referentiemateriaal hebt. Het Pro-afbeeldingsmodel kan daarnaast gebruikmaken van PBR, geometriemodus en een eigen aantal vlakken.
- Afbeelding van de voorkant ingediend als PoYo image_urls
- Optionele velden voor multiview-afbeeldingen bij Pro-afbeeldingsjobs
- Instellingen voor PBR en een eigen aantal vlakken wanneer nodig
02
Pro tekst naar 3D voor uitgewerkte prompts
Gebruik Pro tekst naar 3D wanneer een geschreven omschrijving van het object de vorm, de richting van het materiaal en het algemene concept van de asset moet bepalen. PoYo houdt de API-flow asynchroon, zodat statuspolling en callbacks hetzelfde werken als bij andere 3D-modellen.
- Promptinvoer tot de limiet van het Pro-model
- Optionele PBR, geometriemodus en aantal vlakken
- Uniforme status en ophalen van bestanden
03
Rapid tekst naar 3D voor snellere concepten
Rapid tekst naar 3D is handig voor vroege ideeën, het verkennen van objecten en goedkopere concepten van assets. Gebruik het wanneer korte prompts volstaan en het team snel wil vergelijken voordat er een definitieve richting wordt gekozen.
- Lagere basiskosten in credits dan Pro
- Optionele PBR wanneer geen geometriemodus is gekozen
- Geschikt voor het verkennen van assets en itereren
04
Rapid afbeelding naar 3D vanuit één referentie
Gebruik het Rapid-afbeeldingsmodel wanneer je al een referentie hebt van een product, rekwisiet, schets of object en snel een 3D-resultaat wilt. PoYo accepteert een eenvoudige image_urls-invoer en geeft genormaliseerde taakresultaten terug.
- Eén afbeeldingsbron voor het Rapid-model
- PBR- of geometrie-opties waar die worden ondersteund
- Teruggegeven thumbnails en modelbestanden genormaliseerd door PoYo
Toepassingen
01
Ideeën voor game-rekwisieten
Genereer vroege concepten van rekwisieten uit prompts of objectreferenties, voordat je tijd steekt in handmatig modelleren.
02
Visualisatie van producten en objecten
Zet referenties van de voorkant of uit meerdere aanzichten om in 3D-uitvoer voor beoordeling, prototyping en vervolgstappen in asset-pipelines.
03
Batchgewijs 3D-assets verkennen
Vergelijk Pro- en Rapid-resultaten in één API-formaat, met consistente prijzen, taakstatus en het ophalen van bestanden.
04
Asynchrone 3D-pipelines
Dien Hunyuan 3D-jobs in met callbacks of polling en stuur voltooide modelbestanden door naar je productietools.
Hunyuan 3D v3.1 Pro vs Rapid
Globale vergelijking van de vier Hunyuan 3D v3.1-modellen die PoYo aanbiedt.
| Functie | Pro | Rapid |
|---|---|---|
| Invoermodellen | Tekst naar 3D en afbeelding naar 3D | Tekst naar 3D en afbeelding naar 3D |
| Het beste voor | Jobs met meer controle, waarvoor PBR, geometriemodus, aantal vlakken of sturing met multiview nodig is | Goedkopere concepten en sneller itereren vanuit prompts of één afbeelding |
| Promptlengte | Tot 1024 tekens | Tot 200 tekens |
| Afbeeldingsinstellingen | Afbeelding van de voorkant plus optionele extra URL's voor aanzichten bij Pro-afbeeldingsjobs | Invoer van één afbeelding van de voorkant |
| Prijsopbouw | 60 credits basis, met optionele toeslagen | 36 credits basis, met optionele PBR-toeslag |
De exacte beschikbare uitvoer hangt af van het gekozen model en de teruggegeven bestanden.
Zo gebruik je de Hunyuan 3D v3.1 API op PoYo
Stap 1: Maak een API-sleutel aan
Registreer je op PoYo en maak een API-sleutel aan in je dashboard.
API-sleutel aanmaken ->
Stap 2: Kies een Hunyuan 3D v3.1-model
Kies een van de vier publieke model-ID's: Pro afbeelding, Pro tekst, Rapid tekst of Rapid afbeelding.
Stap 3: Dien je PoYo-invoer in
Gebruik prompt voor tekstmodellen of image_urls voor afbeeldingsmodellen. Voeg velden voor PBR, geometrie, aantal vlakken of multiview alleen toe als het gekozen model die ondersteunt.
Stap 4: Haal de gegenereerde assets op
Poll het status-endpoint van de taak of geef een callback-URL op en download daarna de teruggegeven GLB-, OBJ-, MTL-, textuur-, thumbnail- of model-URL-bestanden, voor zover beschikbaar.
Documentatie bekijken ->
Prijzen van de Hunyuan 3D v3.1 API
Hunyuan 3D v3.1 op PoYo hanteert prijzen per generatie, met optionele toeslagen.
Pro-modellen beginnen bij 60 credits ($0.30) per generatie. Rapid-modellen beginnen bij 36 credits ($0.18) per generatie.
Ondersteunde toeslagen kosten 24 credits ($0.12) per stuk. Toeslagen gelden onder meer voor PBR waar van toepassing, multiview-invoer bij Pro-afbeeldingsjobs en een eigen aantal vlakken bij Pro-jobs.
Voeg credits toe en begin met het testen van Hunyuan 3D v3.1 op PoYo. Credits opwaarderen ->
Veelgestelde vragen
Welk Hunyuan 3D v3.1-model moet ik kiezen?
Gebruik Pro als je extra instellingen nodig hebt, zoals PBR, geometriemodus, een eigen aantal vlakken of sturing met multiview-afbeeldingen. Gebruik Rapid voor goedkopere concepten uit tekst of één afbeelding.
Hoe werkt afbeeldingsinvoer op PoYo?
Dien afbeeldingsmodellen in met image_urls met daarin één URL van een afbeelding van de voorkant. PoYo houdt het invoerformaat voor gebruikers hetzelfde bij alle afbeeldingsmodellen van Hunyuan 3D.
Kan ik multiview-afbeeldingen gebruiken?
Ja, maar alleen met hunyuan-3d/v3.1/pro/image-to-3d. Optionele velden voor aanzichten zijn onder meer de afbeeldings-URL's voor achter, links, rechts, boven, onder, linksvoor en rechtsvoor.
Welke bestanden kan de API teruggeven?
Resultaten kunnen GLB-, OBJ- en MTL-bestanden, textuurbestanden, thumbnails en verzamelingen model-URL's bevatten, afhankelijk van het gekozen Hunyuan 3D v3.1-model.
Waarom PoYo.ai gebruiken
01
Eén asynchrone 3D-API
Gebruik hetzelfde patroon voor indienen, status, callbacks en het ophalen van bestanden bij alle vier de Hunyuan 3D v3.1-modellen.
02
Transparante prijzen in credits
Zie vóór het indienen van een job duidelijk wat de basiscredits voor de generatie en de toeslagen zijn.
03
Instellingen per model
De playground toont alleen de instellingen die het gekozen Pro- of Rapid-model ondersteunt.
04
Genormaliseerde uitvoerbestanden
PoYo verzamelt de teruggegeven model-, textuur- en thumbnailbestanden in een consistent formaat voor taakresultaten.