Hoppa till innehåll

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

Integrera

Modell-id hyper3d/rodin/v2.5/text-to-3d/fast
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hyper3d/rodin/v2.5/text-to-3d/fast?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

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

Den här begäran: 0,10 $ 100 API-krediter · ≈ 10,76 ₽ Kör den på den här sidan

Hämta API-nyckel
Hyper3D Text till 3D 4K-utdataSnabb #text-to-3d

Snabb text-till-3D med Rodin V2.5 begränsad till låga nivåer för snabb prototypframtagning

Hyper3D · 3D

Ditt första resultat visas här

Skapa en begäran nedan och kör den med din API-nyckel. Utdata kopieras till vår lagring och sparas för alltid eller 7 dagar kostnadsfritt.

Skapa en begäran

Kontrollerna genereras från modellschemat. Koden och priset uppdateras när du ändrar dem.

•obligatoriskt 88 / 1024

Textinstruktioner som styr modellgenereringen; obligatoriska i Text-to-3D-läge.

Avancerat geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · enable_safety_checker · bbox_condition
geometry_file_format standard glb

Filformat för geometri, valt från glb, usdz, fbx, obj, stl; standard är glb.

material standard Shaded

Val av materialutdata: välj None för geometri utan texturer eller All för att få båda materialvarianterna. För realistisk belysning med fysiskt baserade material väljer du PBR; för bakad belysning utan PBR-mappar väljer du Shaded.

texture_mode

Välj texturkvalitet uttryckligen eller låt API:t välja, vilket använder ett standardvärde som passar nivån.

standard Gen-2.5-Extreme-Low

Genereringsnivå; Gen-2.5-Minimum tvingar fram minimum-läge och ett 50K Triangle-mesh oavsett `quality_mesh_option`. Information om nivåerna finns i [Hyper3D-dokumentationen](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

standard Auto

Välj kvalitet tillsammans med mesh-topologi: Quad prioriterar släta ytor, medan Triangle prioriterar geometriska detaljer. Den snabba ändpunkten är främst avsedd för testning och prototyper, med ett tak på 20K; använd standardändpunkten för mesh med högre kvalitet, där Minimum, Extreme-Low och Low stöder upp till 1M Triangle och tillgängligt antal ytor beror på nivån. I Hyper3D API anger `quality_override` antalet ytor, medan `mesh_mode` anger Quad/Raw. Auto väljer de rekommenderade inställningarna: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Valfri slumpmässig seed med intervallet 0–65535.

Begränsa hur stor den genererade modellen får vara med hjälp av en ControlNet.

POST /run/hyper3d/rodin/v2.5/text-to-3d/fast?wait=20 pris → 0,10 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hyper3d/rodin/v2.5/text-to-3d/fast?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

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

Kör den här begäran

Din nyckel stannar i den här webbläsaren: den skickas endast till Doitong API och sparas endast i localStorage om du markerar Kom ihåg. Hämta en API-nyckel

Om Hyper3D - Rodin V2.5 - Text to 3D - Fast

Omvandlar en obligatorisk `prompt` (upp till 1024 tecken) till en 3D-modell med de lättare nivåerna Minimum, Extreme-Low (standard) och Low. Nätalternativen går upp till 20K polygoner och materialet är Shaded som standard. Stöder utdata i glb, usdz, fbx, obj och stl, ett `seed` från 0 till 65535 samt `TAPose` för figurer.

Parametrar

NamnTyp StandardTillåtna Beskrivning
promptobligatoriskt
Typstring
≤ 1 024 tecken
Textinstruktioner som styr modellgenereringen; obligatoriska i Text-to-3D-läge.
tiervalfritt
Typenum
StandardGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Genereringsnivå; Gen-2.5-Minimum tvingar fram minimum-läge och ett 50K Triangle-mesh oavsett `quality_mesh_option`. Information om nivåerna finns i [Hyper3D-dokumentationen](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
seedvalfritt
Typinteger | null
0 – 65 535
Valfri slumpmässig seed med intervallet 0–65535.
geometry_file_formatvalfritt
Typenum
Standardglb
glbusdzfbxobjstl
Filformat för geometri, valt från glb, usdz, fbx, obj, stl; standard är glb.
materialvalfritt
Typenum
StandardShaded
PBRShadedAllNone
Val av materialutdata: välj None för geometri utan texturer eller All för att få båda materialvarianterna. För realistisk belysning med fysiskt baserade material väljer du PBR; för bakad belysning utan PBR-mappar väljer du Shaded.
quality_mesh_optionvalfritt
Typenum
StandardAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Välj kvalitet tillsammans med mesh-topologi: Quad prioriterar släta ytor, medan Triangle prioriterar geometriska detaljer. Den snabba ändpunkten är främst avsedd för testning och prototyper, med ett tak på 20K; använd standardändpunkten för mesh med högre kvalitet, där Minimum, Extreme-Low och Low stöder upp till 1M Triangle och tillgängligt antal ytor beror på nivån. I Hyper3D API anger `quality_override` antalet ytor, medan `mesh_mode` anger Quad/Raw. Auto väljer de rekommenderade inställningarna: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modevalfritt
Typenum
legacyextreme-lowlowmediumhigh
Välj texturkvalitet uttryckligen eller låt API:t välja, vilket använder ett standardvärde som passar nivån.
enable_creative_modevalfritt
Typboolean
Standardfalse
Kreativt genereringsläge, motsvarande `geometry_instruct_mode` inställt på `creative` i Hyper3D API. När det aktiveras blir genereringen mer robust utan att utdata blir mindre konsekvent.
hd_texturevalfritt
Typboolean
Standardfalse
Styr avancerad efterbehandling av texturer för att förbättra visuell återgivning.
texture_delightvalfritt
Typboolean
Standardfalse
Tar bort inbakad belysning och högdagrar från genererade texturer.
is_microvalfritt
Typboolean
Standardfalse
Lägger till finare geometriska detaljer på mikronivå; gäller endast när `tier="Gen-2.5-Extreme-High"`.
TAPosevalfritt
Typboolean
Standardfalse
Inställning för karaktärspose som underlättar riggning och animering i 3D-programvara: när den aktiveras genereras karaktärer i T-pose eller A-pose.
bbox_conditionvalfritt
Typobject
Begränsa hur stor den genererade modellen får vara med hjälp av en ControlNet.
bbox_condition.widthvalfritt
Typinteger
Standard0
1 – 2 048
Breddbegränsning för begränsningsboxen längs x-axeln.
bbox_condition.heightvalfritt
Typinteger
Standard0
1 – 2 048
Höjdbegränsning för begränsningsboxen längs y-axeln.
bbox_condition.lengthvalfritt
Typinteger
Standard0
1 – 2 048
Längdbegränsning för begränsningsboxen längs z-axeln.
enable_safety_checkervalfritt
Typboolean
Standardtrue
Granskningen kan lättas genom att ange false, om anroparen är behörig.
obligatoriskt

Resultat

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/text-to-3d/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": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dina filer, ditt valVarje outputs[].url är en kopia i vår lagring: sparad för alltid (debiteras per GB-månad) eller 7 dagar kostnadsfritt, enligt din kontoinställning eller ?storage=.
Samma struktur för varje modelltype, url, content_type, width, height och duration, för bilder, video och ljud. output är modellens eget resultatobjekt.
Resultatets fält
model_mesh
object {url, content_type, file_name, file_size}Fil som innehåller det genererade 3D-objektet.
model_meshes
array of object {url, content_type, file_name, file_size}Extra 3D-objektfiler som genereras av Hyper3D och returneras utöver model_mesh.
seed
integerSeed som används under genereringen.
textures
array of object {url, content_type, file_name, file_size, width, height}Texturer som skapats för 3D-objektet.

Fler modeller: Text till 3D

För AI-agenter: den här sidan som Markdown finns på https://doitong.com/sv/developers/models/hyper3d/rodin/v2.5/text-to-3d/fast.md. Alla modeller och guider: https://doitong.com/developers/llms.txt