Naar inhoud springen

Hyper3D - Rodin V2.5 - Image to 3D - Fast

Integreren

Model-ID hyper3d/rodin/v2.5/fast
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5/fast?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Deze request: $ 0,10 100 API-tegoed Op deze pagina uitvoeren

API-sleutel ophalen
Hyper3D Afbeelding naar 3D 4K-uitvoerSnel #image-to-3d

Snellere Rodin V2.5 van afbeelding naar 3D, beperkt tot de drie laagste niveaus voor snel prototypen

Hyper3D · 3D

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

0 / 1024

Begeleid de generatie met tekst, of laat het model automatisch een prompt uit de afbeeldingen afleiden door dit leeg te laten in de modus Image-to-3D.

Geavanceerd images · geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · use_original_alpha · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · preview_render · enable_safety_checker · bbox_condition
image_urls
Sleep een bestand hierheen of · maximaal 5

URL's van bronafbeeldingen, beperkt tot 5 afbeeldingen en verplicht in de modus Image-to-3D, voor het genereren van het model.

geometry_file_format standaard glb

Bestandsindeling voor geometrie, gekozen uit glb, usdz, fbx, obj, stl; standaard glb.

material standaard Shaded

Selectie van materiaaluitvoer: kies None voor geometrie zonder texturen of All om beide materiaalvarianten te ontvangen. Kies PBR voor realistische belichting met fysiek gebaseerde materialen; kies Shaded voor ingebakken belichting zonder PBR-kaarten.

texture_mode

Kies de textuurkwaliteit expliciet of laat de keuze over aan de API, die een standaard gebruikt die geschikt is voor de laag.

standaard Gen-2.5-Extreme-Low

Generatielaag; Gen-2.5-Minimum forceert de minimummodus en een mesh van 50K Triangle, ongeacht `quality_mesh_option`. Details over de lagen staan in de [Hyper3D-documentatie](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

standaard Auto

Kies kwaliteit samen met mesh-topologie: Quad geeft de voorkeur aan gladde oppervlakken, terwijl Triangle de voorkeur geeft aan geometrische details. Het snelle endpoint is vooral bedoeld voor testen en prototyping, met een limiet van 20K; gebruik het standaardendpoint voor meshes van hogere kwaliteit, waarbij Minimum, Extreme-Low en Low maximaal 1M Triangle ondersteunen en het beschikbare aantal vlakken afhankelijk is van de laag. In de Hyper3D API geeft `quality_override` het aantal vlakken op, terwijl `mesh_mode` Quad/Raw specificeert. Auto selecteert de aanbevolen instellingen: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Optionele willekeurige seed met een bereik van 0–65535.

Beperk met een ControlNet hoe groot het gegenereerde model mag zijn.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 prijsopgave → $ 0,10
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2.5/fast?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Hyper3D - Rodin V2.5 - Image to 3D - Fast

Maakt een 3D-model uit één tot vijf afbeeldingen in `image_urls`, met een optionele `prompt`. `tier` is beperkt tot Minimum, Extreme-Low (standaard) en Low, en meshopties gaan tot maximaal 20K vlakken. Material staat standaard op Shaded. Uitvoerformaten zijn glb, usdz, fbx, obj of stl.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
image_urlsoptioneel images
Typeurl[] · image
≤ 5 items
URL's van bronafbeeldingen, beperkt tot 5 afbeeldingen en verplicht in de modus Image-to-3D, voor het genereren van het model.
tieroptioneel
Typeenum
StandaardGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Generatielaag; Gen-2.5-Minimum forceert de minimummodus en een mesh van 50K Triangle, ongeacht `quality_mesh_option`. Details over de lagen staan in de [Hyper3D-documentatie](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptoptioneel
Typestring
Standaard
≤ 1.024 tekens
Begeleid de generatie met tekst, of laat het model automatisch een prompt uit de afbeeldingen afleiden door dit leeg te laten in de modus Image-to-3D.
use_original_alphaoptioneel
Typeboolean
Standaardfalse
Regelt het behoud van transparantiekanalen van invoerafbeeldingen bij het genereren van 3D-inhoud.
seedoptioneel
Typeinteger | null
0 – 65.535
Optionele willekeurige seed met een bereik van 0–65535.
geometry_file_formatoptioneel
Typeenum
Standaardglb
glbusdzfbxobjstl
Bestandsindeling voor geometrie, gekozen uit glb, usdz, fbx, obj, stl; standaard glb.
materialoptioneel
Typeenum
StandaardShaded
PBRShadedAllNone
Selectie van materiaaluitvoer: kies None voor geometrie zonder texturen of All om beide materiaalvarianten te ontvangen. Kies PBR voor realistische belichting met fysiek gebaseerde materialen; kies Shaded voor ingebakken belichting zonder PBR-kaarten.
quality_mesh_optionoptioneel
Typeenum
StandaardAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Kies kwaliteit samen met mesh-topologie: Quad geeft de voorkeur aan gladde oppervlakken, terwijl Triangle de voorkeur geeft aan geometrische details. Het snelle endpoint is vooral bedoeld voor testen en prototyping, met een limiet van 20K; gebruik het standaardendpoint voor meshes van hogere kwaliteit, waarbij Minimum, Extreme-Low en Low maximaal 1M Triangle ondersteunen en het beschikbare aantal vlakken afhankelijk is van de laag. In de Hyper3D API geeft `quality_override` het aantal vlakken op, terwijl `mesh_mode` Quad/Raw specificeert. Auto selecteert de aanbevolen instellingen: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modeoptioneel
Typeenum
legacyextreme-lowlowmediumhigh
Kies de textuurkwaliteit expliciet of laat de keuze over aan de API, die een standaard gebruikt die geschikt is voor de laag.
enable_creative_modeoptioneel
Typeboolean
Standaardfalse
Creatieve generatiemodus, gelijk aan `geometry_instruct_mode` ingesteld op `creative` in de Hyper3D API. Inschakelen maakt de generatie robuuster zonder de consistentie van de uitvoer op te offeren.
hd_textureoptioneel
Typeboolean
Standaardfalse
Regelt geavanceerde nabewerking van texturen om de visuele getrouwheid te verbeteren.
texture_delightoptioneel
Typeboolean
Standaardfalse
Verwijdert ingebakken belichting en highlights uit gegenereerde texturen.
is_microoptioneel
Typeboolean
Standaardfalse
Voegt fijnere geometrische details op microschaal toe; werkt alleen wanneer `tier="Gen-2.5-Extreme-High"`.
TAPoseoptioneel
Typeboolean
Standaardfalse
Instelling voor de karakterhouding voor eenvoudiger rigging en animatie in 3D-software: inschakelen genereert personages in een T-pose of A-pose.
bbox_conditionoptioneel
Typeobject
Beperk met een ControlNet hoe groot het gegenereerde model mag zijn.
bbox_condition.widthoptioneel
Typeinteger
Standaard0
1 – 2.048
Breedtebeperking van het begrenzingsvak langs de x-as.
bbox_condition.heightoptioneel
Typeinteger
Standaard0
1 – 2.048
Hoogtebeperking van het begrenzingsvak langs de y-as.
bbox_condition.lengthoptioneel
Typeinteger
Standaard0
1 – 2.048
Lengtebeperking van het begrenzingsvak langs de z-as.
preview_renderoptioneel
Typeboolean
Standaardfalse
Schakelaar voor preview-rendering die een afbeelding van het gegenereerde 3D-model toevoegt aan de geleverde modelbestanden.
enable_safety_checkeroptioneel
Typeboolean
Standaardtrue
Screening kan worden versoepeld door false in te stellen, mits de aanroeper is geautoriseerd.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/fast",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "prompt": ""
  },
  "output": {
    "model_mesh": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_meshes": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    ],
    "seed": 42,
    "textures": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
model_mesh
object {url, content_type, file_name, file_size}Bestand met het gegenereerde 3D-object.
model_meshes
array of object {url, content_type, file_name, file_size}Extra 3D-objectbestanden die door Hyper3D worden gegenereerd en naast model_mesh worden teruggegeven.
seed
integerSeed die tijdens de generatie wordt toegepast.
textures
array of object {url, content_type, file_name, file_size, width, height}Texturen die voor het 3D-object zijn geproduceerd.

Meer modellen: Afbeelding naar 3D

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/hyper3d/rodin/v2.5/fast.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt