01
hunyuan-3d/v3.1/pro/image-to-3d
Konvertér et billede af et objekt forfra til et 3D-asset med Pro-kontrol over PBR, geometritilstand, tilpasset antal flader og valgfri ekstra billeder fra andre vinkler.
hunyuan-3d/v3.1/pro/text-to-3d
Model:
Hunyuan 3D v3.1 API understøtter Pro- og Rapid-generering af tekst til 3D og billede til 3D til spil, produktvisualisering, prototyper og 3D-asset-pipelines.
Examples
Prisdetaljer
Betal efter forbrug. Intet abonnement og ingen skjulte gebyrer.
| Niveau | Tekst til 3D | Billede til 3D |
|---|---|---|
| Pro | $0.300/gen. 60 kreditter/gen. $0.375/gen.Spar 20 % | $0.300/gen. 60 kreditter/gen. $0.375/gen.Spar 20 % |
| Rapid | $0.180/gen. 36 kreditter/gen. $0.225/gen.Spar 20 % | $0.180/gen. 36 kreditter/gen. $0.225/gen.Spar 20 % |
Eksempel på pris (Rapid · Tekst til 3D · Grundgenerering): 10 genereringer: $1.80
Tilkøb
| Niveau | PoYo-pris | Original / rabat |
|---|---|---|
| Pro · Billede til 3D · PBR-materialer | +$0.120 24 kreditter | +$0.150Spar 20 % Officiel |
| Pro · Billede til 3D · Input fra flere vinkler | +$0.120 24 kreditter | +$0.150Spar 20 % Officiel |
| Pro · Tekst til 3D · Tilpasset antal flader | +$0.120 24 kreditter | +$0.150Spar 20 % Officiel |
Sådan afregnes det: Fast pris pr. generering. Tilkøb afregnes oven i grundprisen.
Prisen beregnes ud fra det endelige output.
Introduktion
Komplet guide til at bruge Hunyuan 3D v3.1 API
Hunyuan 3D v3.1 API
Hunyuan 3D v3.1 på PoYo.ai giver adgang til fire modeller med ensartet afsendelse af opgaver, statuspolling, callback-understøttelse og 3D-output, der kan downloades, når genereringen er færdig.
Tilgængelige modeller
Hent API-nøgle
02
hunyuan-3d/v3.1/pro/text-to-3d
Start med en længere tekstprompt, og brug Pro-indstillinger som PBR, geometritilstand og tilpasset antal flader for en mere kontrolleret generering af assets.
03
hunyuan-3d/v3.1/rapid/text-to-3d
Generér hurtige 3D-udkast ud fra kortere prompts med Rapid-priser og valgfri PBR eller geometrifokuseret kontrol over output.
04
hunyuan-3d/v3.1/rapid/image-to-3d
Omdan et enkelt objektbillede til en 3D-model med den billigere Rapid-billedmodel og valgfrie PBR- eller geometriindstillinger.
Vigtigste funktioner i Hunyuan 3D v3.1 API
Vælg Pro- eller Rapid-modellerne i Hunyuan 3D v3.1 til generering af tekst til 3D og billede til 3D med PoYo's tilgængelige kontroller og asynkron API-adgang.
01
Pro billede til 3D med vejledning fra flere vinkler
Upload ét billede af objektet forfra, og tilføj valgfrit billeder fra siden, bagfra, oppefra, nedefra eller på skrå, når du har flere referencer. Pro-billedmodellen kan også bruge PBR, geometritilstand og tilpasset antal flader.
- Billedet forfra sendes som PoYo image_urls
- Valgfrie felter til billeder fra flere vinkler i Pro-billedjobs
- Kontrol over PBR og tilpasset antal flader, når det er nødvendigt
02
Pro tekst til 3D til detaljerede prompts
Brug Pro tekst til 3D, når en skriftlig beskrivelse af objektet skal styre formen, materialeretningen og det samlede koncept for asset'et. PoYo holder API-flowet asynkront, så statuspolling og callbacks fungerer på samme måde som for andre 3D-modeller.
- Promptinput op til Pro-modellens grænse
- Valgfri PBR, geometritilstand og antal flader
- Samlet status og hentning af filer
03
Rapid tekst til 3D til hurtigere udkast
Rapid tekst til 3D er nyttig til tidlig idéudvikling, udforskning af objekter og billigere udkast til assets. Brug den, når korte prompts er nok, og teamet hurtigt skal sammenligne, før en endelig retning vælges.
- Lavere grundpris i kreditter end Pro
- Valgfri PBR, når geometritilstand ikke er valgt
- Velegnet til udforskning og iteration af assets
04
Rapid billede til 3D ud fra én reference
Brug Rapid-billedmodellen, når du allerede har en produkt-, rekvisit-, skitse- eller objektreference og vil have et hurtigt 3D-resultat. PoYo accepterer et simpelt image_urls-input og returnerer normaliserede opgaveresultater.
- Én billedkilde til Rapid-modellen
- PBR- eller geometriindstillinger, hvor det understøttes
- Returnerede miniaturebilleder og modelfiler normaliseres af PoYo
Anvendelser
01
Idéudvikling af spilrekvisitter
Generér tidlige rekvisitkoncepter ud fra prompts eller objektreferencer, før du bruger tid på manuel modellering.
02
Visualisering af produkter og objekter
Omdan referencer forfra eller fra flere vinkler til 3D-output til gennemgang, prototyper og efterfølgende asset-pipelines.
03
Batch-udforskning af 3D-assets
Sammenlign Pro- og Rapid-resultater i ét API-format, mens priser, opgavestatus og hentning af filer forbliver ensartede.
04
Asynkrone 3D-pipelines
Send Hunyuan 3D-jobs med callbacks eller polling, og led de færdige modelfiler videre til dine produktionsværktøjer.
Hunyuan 3D v3.1 Pro vs Rapid
Overordnet sammenligning af de fire Hunyuan 3D v3.1-modeller, der er tilgængelige på PoYo.
| Funktion | Pro | Rapid |
|---|---|---|
| Inputmodeller | Tekst til 3D og billede til 3D | Tekst til 3D og billede til 3D |
| Bedst til | Jobs med mere kontrol, der kræver PBR, geometritilstand, antal flader eller vejledning fra flere vinkler | Billigere udkast og hurtigere iteration ud fra prompts eller ét billede |
| Promptlængde | Op til 1024 tegn | Op til 200 tegn |
| Billedkontrol | Billede forfra plus valgfrie URL'er til ekstra vinkler i Pro-billedjobs | Ét billede forfra som input |
| Prismodel | 60 kreditter i grundpris med valgfrie tillæg | 36 kreditter i grundpris med valgfrit PBR-tillæg |
Hvilke output der præcist er tilgængelige, afhænger af den valgte model og de returnerede filer.
Sådan bruger du Hunyuan 3D v3.1 API på PoYo
Trin 1: Opret en API-nøgle
Tilmeld dig på PoYo, og opret en API-nøgle i dit dashboard.
Opret API-nøgle ->
Trin 2: Vælg en Hunyuan 3D v3.1-model
Vælg et af de fire offentlige model-id'er: Pro billede, Pro tekst, Rapid tekst eller Rapid billede.
Trin 3: Send PoYo-input
Brug prompt til tekstmodeller eller image_urls til billedmodeller. Tilføj kun felter til PBR, geometri, antal flader eller flere vinkler, hvis den valgte model understøtter dem.
Trin 4: Hent de genererede assets
Poll opgavens statusendpoint, eller angiv en callback-URL, og download derefter de returnerede GLB-, OBJ-, MTL-, tekstur-, miniaturebillede- eller model-URL-filer, når de er tilgængelige.
Se dokumentationen ->
Priser for Hunyuan 3D v3.1 API
Hunyuan 3D v3.1 på PoYo har priser pr. generering med valgfrie tillæg.
Pro-modeller starter ved 60 kreditter ($0.30) pr. generering. Rapid-modeller starter ved 36 kreditter ($0.18) pr. generering.
Understøttede tillæg koster 24 kreditter ($0.12) pr. stk. Tillæg omfatter PBR, hvor det er relevant, input fra flere vinkler i Pro-billedjobs og tilpasset antal flader i Pro-jobs.
Tilføj kreditter, og begynd at teste Hunyuan 3D v3.1 på PoYo. Fyld kreditter op ->
Ofte stillede spørgsmål
Hvilken Hunyuan 3D v3.1-model skal jeg vælge?
Brug Pro, når du har brug for ekstra kontrol som PBR, geometritilstand, tilpasset antal flader eller vejledning med billeder fra flere vinkler. Brug Rapid til billigere udkast ud fra tekst eller ét billede.
Hvordan fungerer billedinput på PoYo?
Send billedmodeller med image_urls, der indeholder én URL til et billede forfra. PoYo holder inputformatet, som brugeren ser, ensartet på tværs af Hunyuan 3D-billedmodellerne.
Kan jeg bruge billeder fra flere vinkler?
Ja, men kun med hunyuan-3d/v3.1/pro/image-to-3d. Valgfrie vinkelfelter omfatter URL'er til billeder af bagsiden, venstre side, højre side, toppen, bunden, venstre forside og højre forside.
Hvilke filer kan API'et returnere?
Resultaterne kan omfatte GLB, OBJ, MTL, teksturfiler, miniaturebilleder og samlinger af model-URL'er, afhængigt af den valgte Hunyuan 3D v3.1-model.
Derfor skal du bruge PoYo.ai
01
Én asynkron 3D-API
Brug samme mønster for afsendelse, status, callback og hentning af filer på tværs af alle fire Hunyuan 3D v3.1-modeller.
02
Gennemsigtige kreditpriser
Se tydeligt, hvad grundprisen i kreditter og tillæggene er, før du sender et job.
03
Modelspecifik kontrol
Playground viser kun de kontroller, som den valgte Pro- eller Rapid-model understøtter.
04
Normaliserede outputfiler
PoYo samler de returnerede model-, tekstur- og miniaturefiler i et ensartet format for opgaveresultater.